Adeyemicodes/nmrs_toolkit

Desktop application to support data management on the Nigeria MRS (Medical Record System) — automated data preparation, reporting workflows, and an in-app analytics dashboard. # NMRS Toolkit NMRS Toolkit is a cross-platform desktop application built to support program data managers and M&E teams working with exports from the Nigeria Medical Record System (NMRS). It automates routine data tasks — line list generation, indicator reporting, and configuration-driven processing — replacing fragile spreadsheet workflows with a reproducible, auditable tool. Originally developed around HIV program workflows, the toolkit is being extended to accommodate additional disease areas, and an integrated analytics dashboard is in progress to deliver cohort, outcome, and trend analyses on demand without moving sensitive patient data into external BI tools. ## Features - Process Nigeria Medical Record System (NMRS) exports into structured outputs - Automated line list generation — 5 bundled linelists (Treatment, PMTCT, EAC, OTZ, AHD) plus any custom `.sql` - **Weekly linelist batch** — generates Treatment, PMTCT, EAC, and AHD in one click, or automatically at 00:00 every Thursday (and on the next startup if the machine was off); written to `~/NMRS_Linelists` (`C:\NMRS_Linelists` on Windows) - Configuration-driven processing via `.nmrs_config.ini` - **Daily encrypted database backups** — runs at 00:00 Mon-Fri and on system startup; gzip + AES-GCM per-facility key; configurable retention - **Database restore** with pre-restore safety backup, typed-name confirmation, and live byte-level progress - **Update Patient (demographics)** — search a patient by ART ID and correct name, sex, birthdate, phone, or address directly in the active database; only changed fields are written, each with a full before/after audit trail (config-gated, hidden by default) - Packaged as a standalone desktop application (Ubuntu build available) ## Roadmap - In-app analytics dashboard (cohort, treatment outcome, and trend analyses) - Expansion beyond HIV to additional disease areas - Cross-platform packaging (Windows, macOS) ## Installation ### Option 1 — Prebuilt binary (Ubu …