Files
medicaltracker/README.md
T
Ty Clifford 17ebaf21a3 -
2026-06-30 12:39:17 -04:00

72 lines
3.3 KiB
Markdown

# 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
```sh
/Users/tyemeclifford/frankenphp php-server --root public --listen 127.0.0.1:8080
```
Then open:
```text
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:
```text
data/health_tracker.sqlite
```
The app seeds sample profiles, medical terminology, condition summaries, a 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.
- 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.
- Medicine catalog with RxNorm, MedlinePlus, PubMed, and ClinicalTrials.gov links.
- 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.
## Reference Sources
- RxNorm and RxNav from the U.S. National Library of Medicine: `https://www.nlm.nih.gov/research/umls/rxnorm/index.html`
- 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.