diff --git a/docs/about-opensrp/admin-dashboard-features/readme.mdx b/docs/about-opensrp/admin-dashboard-features/readme.mdx deleted file mode 100644 index 8723aa325c..0000000000 --- a/docs/about-opensrp/admin-dashboard-features/readme.mdx +++ /dev/null @@ -1,24 +0,0 @@ ---- -sidebar_position: 3 -sidebar_label: Admin Dashboard Features ---- - -# Admin Dashboard Features - -### Create practitioners - -Enroll practitioners to use OpenSRP 2 by capturing basic details such as name and username, then assigning roles and access permissions. - -### Manage locations - -Add and edit locations based on the health system's prebuilt location hierarchy (the hierarchy is defined when the dashboard is initially set up and is not editable). Locations include name, the parent location, status (active or inactive), and type (jurisdiction or building). - -### Manage care teams - -A care team is a collection of practitioners that conduct similar activities. OpenSRP 2 Dashboard allows the ability to create a care team, add teams to an organization, mark the care team as active or inactive, and add practitioners to a care team. - -It is required to assign care teams to locations. We assign caregiving practitioners to care teams, these care teams are assigned a managing organization. The Organization is the team. Organizations are then assigned to locations. - -### Manage and assign teams - -Practitioners work at locations such as health facilities. Team assignment ensures navigation through the hierarchy of a country to the location where a team is to be assigned and assigning a team to a location. diff --git a/docs/about-opensrp/app-features/readme.mdx b/docs/about-opensrp/app-features/readme.mdx deleted file mode 100644 index e50643fa16..0000000000 --- a/docs/about-opensrp/app-features/readme.mdx +++ /dev/null @@ -1,111 +0,0 @@ ---- -sidebar_position: 2 -sidebar_label: App Features ---- - -# App Features (release v0.2.3–0.2.4) - -## Recording services - -Patient and health service information is captured using forms with questions and fields. The app keeps the interaction as simple as possible and has error-checking to keep entered data accurate. - -**Input fields** - -A range of input fields are available: text/string, , number, boolean, single choice, multiple choice, dropdown, date picker, date and time picker, slider, attachment, display an image and display a label. Fields can be restricted to specific related entires — for example if there is a number entry used for phone number, it can be set to only accept a certain number of digits or else show an error message. Fields can also be set to required, which highlights the field with an error if the user tries to save the form without filling in that field. Each fIeld can have helper text which is accessible when the user taps a question mark icon. - -**Field styling** - -Field styling is flexible with regards to font size and styling. Labels for form can use any font (applying to the entire form), and individual words or sections can have fonts be styled as italic, bold, underline, and color. The back and next button colors and font can also be configured. - -To style without any changes in the FHIRCore/SDK, use HTML tags as part of the question text. The following tags were proven to be applicable to use: - -- Bold: text -- Italic: text -- Underline: text -- Strikethrough: text -- Coloring: text - -**Progress bar** - -A form progress bar can be configured to show or not. A progress bar is helpful in multi-page forms. It shows how far into a form a user is based on the current question viewed within the current total number of questions — and not based on the number of fields answered. - -## Patient and family registration - -A common step in community health programs is creating a list of all persons and households in a health worker's area. OpenSRP supports registering households and people quickly using simple forms. - -Patients and households are associated to a health worker through a location. A health worker is assigned to a specific area or set of areas, and every person they register is assigned to the same area or set of areas. - -In cases where patients visit or health workers cover multiple clinics across area, both the patient and the health worker would be assigned to a higher level location. For example, instead of being assigned to a village, they would be assigned to a facility area or county. That would result in a patient showing up on any of the facility patient lists in that higher level area, and for that patients medical record to be synced to the health worker's device. - -## Finding patients - -Navigating to a patient quickly is paramount for health work, especially when in the community. Because it is common for OpenSRP to be used in places where many people may share similar names, we offer many ways for patient look-up. - -Patients can be searched by NAME or ID. This is a manual search where the patient list is updated after two characters are entered (the results update without pressing "enter"). The search will display patients only assigned to the health worker (Read: how patients are assigned to health workers - this is linked to the appropriate management section) - -The ID can be a national ID number, a local ID number, or an app-generated ID. For a national ID number or local ID number, there is an option to either have the IDs be non-unique (there is no restriction on reusing IDs) or system-unique (it is enforced that IDs are not shared across the system). App-generated IDs are 32 character long strings that are always unique. - -Patients are listed in order of time overdue in each patient register, and can be configured to be listed according to other criteria. For households and patients, that means households with more tasks and more overdue tasks are listed first, and households with fewer tasks and fewer overdue tasks are listed last. - -## Patient records - -Patient records can be configured to show specific information about the patient, such as their demographic details, as well as upcoming Tasks and list of recent visits. What information is shown, the order in which it is shown, and the color and highlighting of the information show are configurable. - -## Care plans - -Care plans are the health service tasks and protocols a patient should receive depending on their status or condition, with the purpose of making sure the right services are provided to patients when they are supposed to be given. The tasks in the care plan are scheduled at the patient receives the updated status. - -For example, a patient who has just been recorded as pregnant will receive a schedule of antenatal visit tasks associated with their gestational age. Each task is completed based on completing a form associated with that task. For example, an antenatal visit in pregnancy week 32 might include a form to check for pregnant danger signs, baby heart beats per minute, and a counseling session, which the health worker can fill out. - -Tasks can be constrained with dates that make them inactive, active/due, overdue, and expired. Taking the example pregnancy scenario above, the week 32 pregnancy visit task can be inactive until week 30, then become active for weeks 30–32, then overdue in weeks 32-35, and expire after week 35. - -OpenSRP has prebuilt care plans for antenatal care, postnatal care, childhood health, and maternal health. - -## Offline mode - -OpenSRP stores patient records entirely offline and is able to register patients and record services without internet or data access. - -**Data syncing** - -When a user is offline and then gets access to the internet with the app is open, records sync automatically with the centralized cloud-based server. Syncing can take place at specific intervals (in order to save battery life) or triggered manually by the user. - -When offline, the most up-to-date patient data exists on the user's device. If a patient record is recorded on another offline device, the data from the more recent encounter is used. - -**Fully offline record sync** - -Sometimes, community health workers or other devices can be so remote as to never be connected to the internet or data connection. In this scenario, OpenSRP supports device-to-device data transfer to update a centralized cloud-based server. The way it works is a person with a device who does access the internet meets with the person with a device who never connects to the internet. Patient records are transferred up the line, from device to device, until records can be synced to the cloud to an internet-connected device. - -Data can be transferred without exposing the patient records in the OpenSRP app. For example, if a health worker does not have access to another health worker's patient data because they are assigned to a different location, data can still be transferred through their device and to the cloud. - -## Tasks - -Tasks are used to identify patients that are due for health services. They are meant to help health workers prioritize who to visit at any given time by prominently appearing in the register list views. - -Tasks in OpenSRP can fit into five categories: (1) inactive and not completable, (2) inactive but completable, (3) active and due, (4) overdue, and (5) expired. Tasks are represented in the app in both register lists and profiles in configurable colors. They are listed in order of due date, and can be configured to be listed according to other criteria stored in the Task. - -Tasks can be due on a specific day or for a time period. The primary settings for a task are the health service form that closes the task and time periods for when the task becomes active, remains active, becomes overdue, and expires. - -## In-app reports - -OpenSRP can generate easy-to-understand indicators used by community health workers to track progress, celebrate successes, and learn about gaps in coverage. -Indicators are calculated from a user's patient list (and so show a health worker's achievements) and are often tied to goals or targets set by health supervisors. They can be grouped by register. - -## Stock and commodity management - -OpenSRP makes stock and commodity management easier for health workers to anticipate how much they need and thus avoid stock outs. - -When stock is received by a health worker, they use a consumption log form to document commodities received. As commodities are provided or used with patients during health services, stock is automatically deducted. If a stock level reaches a predetermined threshold, the app will highlight that commodity so the health worker can obtain more. During the next commodity refill, the app can calculate the correct balance the health worker should receive. - -## Multi-language support - -OpenSRP supports multiple languages through translatable built in content and user managed translations of form and configuration content. -Languages the core application currently supports -How much effort for the core application to support a new language - -## Peer-to-peer data transfer - -OpenSRP supports peer-to-peer data transfer using “WiFi-direct” technology so that 2 off-line devices can connect to each other and synchronize information from one device to another. The receiving device will only be able to view devices it has permission to view, even though it may receive and store in its device database information it does not have permission to view. - -## Roadmap for 2023–2024 -- Editing submitted form data -- Draft and in-progress forms \ No newline at end of file diff --git a/docs/about-opensrp/history/readme.mdx b/docs/about-opensrp/history/readme.mdx deleted file mode 100644 index 776866f8f9..0000000000 --- a/docs/about-opensrp/history/readme.mdx +++ /dev/null @@ -1,58 +0,0 @@ ---- -sidebar_position: 1 -sidebar_label: History ---- - -# History - -### Background - -As an organization we fundamentally believe technology can play a critical role to empower and augment the capabilities of frontline health workers to help them serve. This is critical to overcoming the significant shortage in highly skilled medical professionals that most countries face. Digitally empowered frontline health workers are essential if we want to achieve a more universal, equitable and affordable access to health services. - -Affordable, basic health care such as child immunizations, maternal care, malaria, HIV, and family planning in low resource countries can: - -**Improve health outcomes:** By providing access to necessary medical treatments and management, individuals are able to better control their condition and receive lifesaving care, reducing the risk of complications and improving overall health. - -**Prevent disease progression:** Early detection and management of health issues can prevent the progression of the issue, reducing the risk of complications and improving health outcomes. - -**Reduce poverty:** The cost of managing serious health issues can be significant, and without access to affordable healthcare, many individuals may fall into debt or poverty as a result of medical expenses. - -**Promote economic development:** Improved health outcomes can lead to increased productivity, thereby promoting economic development. - -**Reduce inequality:** Access to healthcare is often limited for marginalized communities, exacerbating existing inequalities. Providing affordable healthcare can help reduce these disparities. - -In summary, access to affordable and effective care for both chronic, acute and preventative conditions is critical to help ensure the overall health, economic and general well being of people around the world. Technology that supports patient centered care can play one important step in helping achieve this. - -### The "smart" register -OpenSRP is designed to be highly intuitive and based on existing paper tools in an effort to be easy to learn by existing health workers. -The paper register is a common health team tool in low resource countries. These books are easy to print and follow a simple tabular format that guides the health care practitioner through a series of inputs. However, paper's downsides — being strictly a data entry that's hard to extract or share information out of, and requiring filling in data over and over again in different places — are what digital health tries to overcome. - -We discovered that a major obstacle in the successful adoption of technology is the first few months of adapting and learning a new platform. - -We used the format of a paper register, which was easy to scan and understand, and upgraded it to be "smart". First, we added "tasks" which are assigned to-do's for health practitioners, which helps them track when services are due and easily see who is overdue. Next, we added some simple checks to make sure data was entered correctly, and offered solutions and decision support for health issues that arise. - -OpenSRP supports health done in the right way, with less focus on rote data collection, and more focus on providing quality care. The software is meant to provide a speedy and helpful user experience where usability is king. - -### What are the WHO SMART guidelines? - -The World Health Organization (WHO) [SMART — Standards-based, Machine-readable, Adaptive, Requirements-based, and Testable — Guidelines](https://www.who.int/teams/digital-health-and-innovation/smart-guidelines/) are a package of tools that include Digital Adaptation Kits (DAKs), which detail the generic health workflows, core data elements, and decision logic derived from WHO guidelines as a starting point for incorporation into digital systems. Additionally, SMART Guidelines include reference software modules derived from WHO guidelines. - -### What is the FHIR standard? - -FHIR, or [Fast Healthcare Interoperability Resources](https://hl7.org/fhir/), is a data standard evolved from HL7, which pioneered the field of health data exchange. Importantly, since its introduction a decade ago, it has become the globally accepted standard describing how to represent and exchange health data. - -### More about OpenSRP - -Blog articles -- [Eight reasons why FHIR is important for global health](https://ona.io/home/eight-reasons-why-fhir-is-important/) -- [Powering interoperability with a FHIR to DHIS2 adapter](https://github.com/opensrp/fhircore/blob/rw-pld-gitbook-sync/docs/readme/history/#overview) - -Videos -- [Global Goods: OpenSRP](https://youtu.be/KOlfiWDr1mw) - -News -- [Case study celebrates lessons and catalytic potential of rapid, iterative software development across three countries](https://bidinitiative.org/blog/case-study-celebrates-lessons-and-catalytic-potential-of-rapid-iterative-software-development-across-three-countries/) -- [OpenSRP named a Global Good by Digital Square](https://ona.io/home/opensrp-named-a-global-good-by-digital-square/) -- [Integration Between MEDSINC and OpenSRP will Link Community-Level Clinical Data with National Health Information Systems](https://www.businesswire.com/news/home/20180130005503/en/Integration-Between-MEDSINC-and-OpenSRP%C2%A0will-Link-Community-Level-Clinical-Data-with-National-Health-Information-Systems) -- [The WHO Family Planning Reference App built on OpenSRP](https://fpdigitalsolution.org/case-study/the-who-family-planning-reference-app-built-on-opensrp/#introduction) -- [OpenSRP is a 2018 Gavi Pacesetter](https://ona.io/home/opensrp-is-a-2018-gavi-pacesetter/) \ No newline at end of file diff --git a/docs/about-opensrp/readme.mdx b/docs/about-opensrp/readme.mdx deleted file mode 100644 index 57a21237ec..0000000000 --- a/docs/about-opensrp/readme.mdx +++ /dev/null @@ -1,30 +0,0 @@ ---- -sidebar_position: 1 -sidebar_label: About OpenSRP ---- - -# About OpenSRP - -OpenSRP is the FHIR-native medical record system for health workers to manage their patients for child health, maternal health and more. - -OpenSRP has three parts: a mobile app for Android devices, a web-based Admin Dashboard, and a Reporting Dashboard. - -**OpenSRP Android App** - -The OpenSRP Android app is used by health workers to: -1. Enroll community members to a medical record system. -2. Turn community members into patients by adding them to a care plan associated with their condition. -3. Set future services a patient should receive based on their care plan, and assign making sure the services happen to health team members as tasks. -4. Clearly visualize overdue patients so the health team can return them to care. -5. Track performance of providing services to patients at individual health care practitioner and facility levels. - -**OpenSRP Admin Dashboard** - -1. Add, edit and remove health worker user accounts. -2. Manage health team organization structure such. as locations, facilities, and line of reporting. -3. View patient information. - -**OpenSRP Reporting Dashboard** - -1. View reporting at many aggregation levels, from system wide down to a single health worker. -2/ Access to data warehouse. \ No newline at end of file diff --git a/docs/about-opensrp/supported-health-domains/readme.mdx b/docs/about-opensrp/supported-health-domains/readme.mdx deleted file mode 100644 index 6c5e2e5f66..0000000000 --- a/docs/about-opensrp/supported-health-domains/readme.mdx +++ /dev/null @@ -1,38 +0,0 @@ ---- -sidebar_position: 4 -sidebar_label: Supported Domains ---- - -# Supported Domains - -### Household Registration - -Understanding the importance of accurate household enumeration in low resource settings, OpenSRP has built a household registration module that can be integrated with any of the other health modules or registers. Within the household registration module, the head of the household and the primary caregiver status can be assigned to an adult. Pregnant women and children under the age of 5 in that household can then be registered as well, under a system-generated unique household identifier. - -### Childhood Immunizations - -OpenSRP provides a robust solution for the management of childhood immunizations. The Immunization module is built in accordance with WHO immunization guidelines and can be adapted to local country contexts. The app has the ability to show a list of children, per village / location that are due specific types of vaccines on a specific day. It therefore helps with outreach planning around community vaccination days. It also helps with reporting and follow-up for children that did not attend a scheduled vaccination event. Features like colour-coding – making it easier to see which children are due or overdue – and the ability to quickly register multiple vaccines that are administered on the same day, contributes to good user experience and easy navigation. The first local adaptation of the immunization module was conducted in Zambia. Mauritania, Malawi, Togo, Guinea, Liberia. Countries like Tunisia are now starting to use the tool as well. - -### Antenatal Care - -OpenSRP digitizes paper registers used for case management of antenatal care (ANC) services for pregnant women. It can track the attendance of ANC clinic visits, as well as household visits by a CHW at community level. This module was developed as a reference platform for the World Health Organization’s new ANC guidelines, and is currently being rolled out in partnership with the WHO and UNICEF in West Africa, with countries in Eastern and Southern Africa also about to start using the tool, from 2020 onwards. - -### Postnatal Care - -OpenSRP provides decision support and reminders for health care workers to support women who have recently had their baby. The app collects information about infant feeding practices, malaria prevention, early childhood developmental milestones, possible birth defects, and immunizations that are due. It also supports the health worker to monitor possible danger signs to look out for, in terms of the mother’s health. - -### Family Planning - -The OpenSRP Family Planning module assists in the management of family planning services in communities and health facilities. It helps the health worker keep record of family planning counselling sessions performed, as well as the preferred methods chosen by their clients. It can also track adverse effects and through built-in decision-support logic, can help to advise what alternative methods can be used, based on the country context. The app can lastly also calculate when family planning methods must be renewed and can remind the health worker and the client of these, during upcoming home visits. - -### Malaria - -Our malaria module offers next generation geospatial health service planning and delivery tracking tool. It focuses on delivering precision service delivery that supports data collection workflows related to malaria response. Interventions include the planning, tasking and map-based tracking of malaria control tasks, that case workers perform in the field. Examples of these interventions include, indoor residual spraying, the distribution of long lasting insecticide treated nets, mass drug administration, proactive case detection, reactive case detection, and community engagement and awareness events. - -### Stock Management - -The OpenSRP stock management module can be integrated into any register (for example ANC, PNC, Family Planning or Immunization Registers), to help the facility- or field based health workers with management of stock and commodities, and does quick summary reports that eliminates the need for manual counting or paper-based reporting. The stock module can also integrate with more sophisticated open source stock management systems, such as OpenLMIS. - -### Stock Management - -The OpenSRP stock management module can be integrated into any register (for example ANC, PNC, Family Planning or Immunization Registers), to help the facility- or field based health workers with management of stock and commodities, and does quick summary reports that eliminates the need for manual counting or paper-based reporting. The stock module can also integrate with more sophisticated open source stock management systems, such as OpenLMIS. \ No newline at end of file