Skip to content

Web-based VistA/MUMPS global explorer — browse VEHU data, view raw globals, write to live MUMPS

Notifications You must be signed in to change notification settings

DukeDeSouth/openvista-explorer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenVistA Explorer

A web-based tool for exploring VistA/MUMPS global structures using real VEHU test data.

Live demo: openvista.cc/app

What it does

  • Browse 193,900+ clinical records from VistA VEHU across 15 packages
  • View raw MUMPS globals with piece-by-piece breakdowns in a side panel
  • Write vitals, problems, and allergies directly to live MUMPS globals
  • See FileMan date formats, pointer resolution, IEN allocation in action

Screenshot

The app shows a clinical patient view on the left with a MUMPS globals panel on the right, displaying the raw ^GMR(120.5), ^DPT, ^AUPNPROB structures behind the clinical data.

Stack

  • Frontend: Single-file HTML/CSS/JS
  • Backend: Python/Flask with SQLAlchemy Core
  • Database: PostgreSQL 17 (bulk reads) + live MUMPS via YottaDB (writes and live panel)
  • MUMPS: VistA VEHU on YottaDB (OSEHRA VEHU Docker image)

Packages covered

Package Global Records
Patients ^DPT Demographics, service history
Problems ^AUPNPROB Problem list with status tracking
Vitals ^GMR(120.5) Vital signs with type resolution
Allergies ^GMR(120.8) Allergy/adverse reactions
Pharmacy ^PSRX Prescriptions, refills, status
Labs ^LR Lab results, panels, ranges
Orders ^OR(100) CPOE orders with status
Notes ^TIU(8925) TIU clinical documents
Consults ^GMR(123) Consult requests and results
Radiology ^RADPT Rad exams and reports
Scheduling ^SCE Appointments
Surgery ^SRF Surgical cases
Immunizations ^AUPNIMM Vaccination records
Mental Health ^YTT MH instruments and scores
PCE ^AUPNVSIT Visits, procedures, diagnoses

Write operations

The app supports writing to live MUMPS globals for:

  • Vitals — Enter vital signs → ^GMR(120.5)
  • Problems — Add/inactivate problems → ^AUPNPROB
  • Allergies — Add allergy records → ^GMR(120.8)

After each write, data is read back from MUMPS to verify persistence.

Setup

Prerequisites

  • Python 3.10+
  • PostgreSQL 17
  • Docker (for VistA VEHU container)

Run VEHU

docker run -d --name vista-vehu \
  --restart unless-stopped \
  download.yottadb.com/yottadb/octo-vehu:latest-master

Install and run

pip install flask sqlalchemy psycopg2-binary gunicorn
export DATABASE_URL="postgresql://user:pass@localhost/openvista"
python migrate_db.py   # load VEHU JSON data into PostgreSQL
gunicorn app:app -b 0.0.0.0:5005 -w 4

Disclaimer

This is an educational tool for exploring VistA/MUMPS global structures.

NOT intended for clinical use. Write operations bypass FileMan validation and do not maintain cross-references, audit trails, or business rule enforcement. IEN allocation is simplified and does not use FileMan's native allocation.

For production VistA integration, use the RPC Broker, FileMan API (^DIE, ^DIK), or a certified FHIR adapter.

License

MIT

About

Web-based VistA/MUMPS global explorer — browse VEHU data, view raw globals, write to live MUMPS

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages