medicaltracker/README.md

Neon Medical Tracker

A dependency-free PHP, HTML5, JavaScript, and SQLite web app for multi-user medical tracking, terminology lookup, medication reference links, and admin-managed profiles.

This app is a personal tracking and reference tool. It is not medical advice, diagnosis, treatment guidance, or a substitute for a clinician or pharmacist.

Run

/Users/tyemeclifford/frankenphp php-server --root public --listen 127.0.0.1:8080

Then open:

http://127.0.0.1:8080

Public Routes

• / - public homepage for the medical tracker service.
• /workouts.php - condition-tracking feature page.
• /nutrition.php - medicine catalog feature page.
• /recovery.php - NIH/NLM research links page.
• /medical.php - medical terminology, conditions, medicines, and study-link database.
• /signup.php - public profile signup.
• /tracker.php - the medical tracker dashboard.
• /admin.php - admin user-management dashboard.

Storage

SQLite is created automatically at:

data/health_tracker.sqlite

The app seeds sample profiles, medical terminology, condition summaries, an expanded medication catalog, NIH/NLM study-link categories, medication logs, vitals, labs, symptoms, allergies, appointments, immunizations, and the older optional wellness/fitness data.

Included

• Multi-user profiles with separate records and theme preferences.
• Admin dashboard for creating, editing, activating/deactivating, and deleting user profiles.
• Admin medicine-source updater for refreshing the catalog from RxNorm, DailyMed, and openFDA.
• First user created in a database is automatically promoted to admin; later users default to member.
• Daily, weekly, and monthly views for medical logs.
• Medication logging by date, dose, route, frequency, status, prescriber, and notes.
• Vital logs for blood pressure, pulse, temperature, oxygen saturation, glucose, pain score, symptoms, and notes.
• Lab result records with units, reference ranges, clinician/source notes, and collection dates.
• Symptom journal, allergy list, appointments, and immunization records.
• Medical terminology and condition database with source links.
• Searchable medicine catalog by generic name, active ingredient, chemical name, common brand names, and generic/alternate names.
• Medicine links to RxNorm, DailyMed, PubChem, MedlinePlus, PubMed, and ClinicalTrials.gov.
• NIH/NLM research-link categories related to the listed medicines.
• Neon dark theme by default, light mode option, and green, blue, red, pink, and orange accents.
• Optional legacy fitness, nutrition, and supplement tracking remains available as wellness context.

Medicine Catalog Updates

The catalog ships with a curated starter set, the current SQLite file includes thousands of imported medicine concepts, and it can be refreshed from public medicine sources.

From the admin dashboard, use the medicine source updater and choose All sources, RxNorm, DailyMed, or openFDA.

From the command line:

/Users/tyemeclifford/frankenphp php-cli scripts/update_medicine_catalog.php 1000 all

For a periodic cron-style update, run the same command nightly or weekly. The first argument is the max rows per source, from 25 to 5000; the second argument is all, RxNorm, DailyMed, or openFDA.

Reference Sources

• RxNorm and RxNav from the U.S. National Library of Medicine: https://www.nlm.nih.gov/research/umls/rxnorm/index.html
• DailyMed label search from the U.S. National Library of Medicine: https://dailymed.nlm.nih.gov/dailymed/
• PubChem chemical/compound search from NCBI: https://pubchem.ncbi.nlm.nih.gov/
• MedlinePlus condition and medication pages: https://medlineplus.gov/
• PubMed search links for medicine and condition research: https://pubmed.ncbi.nlm.nih.gov/
• ClinicalTrials.gov search links for study discovery: https://clinicaltrials.gov/
• NIH/NIDDK Diabetes Prevention Program: https://www.niddk.nih.gov/about-niddk/research-areas/diabetes/diabetes-prevention-program-dpp
• NIH/NHLBI SPRINT study page: https://www.nhlbi.nih.gov/science/systolic-blood-pressure-intervention-trial-sprint-study
• NIH/NHLBI asthma page: https://www.nhlbi.nih.gov/health/asthma
• NIH/NIMH depression page: https://www.nimh.nih.gov/health/topics/depression

Photo Credits

• Jogging Woman in Grass by Mike Baird, CC BY 2.0.
• Cycling in Amsterdam (893) by FaceMePLS, CC BY-SA 2.0.
• A large mixed salad by Jmabel, CC BY-SA 4.0.