Glossary — PatientPower

📚

Reference · Both Deployments

Glossary & Feature Inventory

Side-by-side reference for production patient-power and test3 (rooms POC). Updated 2026-05-25.

🏛️ Production patient-power

patientpower.xyz

Single index.html (15,619 lines)
Tables + tabbed sections
Live production — git auto-deploy
No auth, no cloud sync

🧪 test3 (rooms POC)

beyondmychart.com

alias: rad-fudge-37b7e3.netlify.app

9 rooms → 22+ portal pages
Avatar-dominant + orbital chips
Active development — drag-and-drop deploy
Supabase auth + per-item cloud sync + sharing

Architecture UX Backend AI / voice Clinical patterns Wave releases

🏗️Architecture

Hub Both: Landing page. Production: single page with anchored sections. test3: 9 room-orbits arranged radially.
Room test3: Top-level area on the hub: Vault, My Health, Cost Tracker, Records I/O, Community, My Care, PowerCoach, Practitioner Marketplace, Intelligence Platform.
Portal test3: Sub-page accessed from a room (vault.html, xrays.html, family-history.html, etc.).
Orbit test3: Circular UI pattern: large avatar at center, action chips arranged around it.
Sub-orbit test3: Second-level orbit within a portal (e.g., 8 sub-orbits inside My Health: Doctors, Scan & Analyze, etc.).

🎨UX & interaction

Avatar-dominant UX test3: Every portal centers a large clickable avatar. Tap to talk to that portal's coach.
Coach Both: Context-specific AI assistant. Examples: VAULT-01 (records), ATLAS-01 (whole-person), MENTAL-01 (mental health), ACTIONS-01 (next steps).
Coach chip test3: "💬 Ask Coach" button in top-bar of every portal.
3-chip pattern test3: Every room hub has the same 3 chips: 📎 Attach · 💬 Ask Coach · ☁️ Synced.
Sync chip test3: Supabase auto-sync status indicator. Green = synced. Replaces top-bar Home link.
Push-and-hold test3: Voice UX: hold the mic to record, release to transcribe via Whisper.
Attach photo Both: Vision-AI upload for label / document / pill-bottle analysis.

🗄️Backend & data

localStorage keys Both: Both apps namespace per category. Production: patient_meds, patient_imaging, etc. test3: pp_test3_meds_v1, pp_test3_surgeries_v1, etc.
Auto-sync test3: pp_supabase.js patches localStorage.setItem to mirror writes to the cloud automatically.
Per-item merge test3 · Wave 3.1: Sync conflict resolution: arrays union by id with latest updatedAt winning; objects union by top-level key with cloud winning.
Magic-link auth test3: Supabase passwordless email login. No password stored anywhere.
Physician sharing test3 · Wave 3.2: Invite token grants read-only access to selected categories via physician-view.html?t=<token>. Permissions stored as JSONB.
Community backend test3 · Wave 3.3: 6 Supabase tables: groups, group_members, posts, reactions, challenges, participants.

🎤AI & voice

Whisper STT test3: OpenAI Whisper via /.netlify/functions/transcribe. Replaced unreliable browser SpeechRecognition.
Anthropic chat Both: Claude Sonnet 4.6 via /.netlify/functions/chat. Powers every coach.
TTS test3: Browser speechSynthesis for audio reply.
Vision analysis Both: Image upload → AI extraction of pills, labels, lab reports.
Avatar-as-mic test3: Voice modal overlays page's avatar on mic button with state ring: blue idle / red listening / green speaking.

🩺Clinical patterns

Severity heuristic test3 · imaging: Keyword classifier from AI-analysis text. Flagged: urgent / critical / severe / mass / fracture / hemorrhage. Moderate: significant / abnormal / stenosis. Normal: unremarkable / WNL.
Risk clustering test3 · family: Auto-flags any condition appearing in 2+ relatives OR with onset before age 60.
Claim workflow test3 · cost: pending → approved → denied → paid. Click-to-cycle status badges.
Appeal workflow Production · cost: Submitted → Approved → Denied → Appeal Filed → Appeal Won / Appeal Denied.
MRI safety Both · devices: Unknown / Safe / Conditional / Unsafe flag. Critical for imaging decisions.
Follow-up highlight Both · surgeries: Chip colored by proximity: yellow if ≤14 days, blue if further out, gray if past.
Replacement overdue Both · devices: Red ⚠️ flag if past due, yellow ⏰ if ≤30 days away.
Adherence streak test3 · Wave 2.1: Daily-dose log on meds + supps with 🔥 streak counter.

🌊Wave releases (test3 versioning)

Wave 1.x: Auth + sync foundation.
Wave 2.1: Medication / supplement adherence streaks.
Wave 2.2: Imaging severity tags + filter pills + reviewed toggle.
Wave 2.3: Family history depth: status, cause-of-death, hereditary risk.
Wave 2.4: Cost claim workflow: pending → approved → denied → paid.
Wave 2.5: Surgeries + devices vault tabs. Backfilled with follow-up date + MRI safety + replacement overdue (2026-05-25).
Wave 3.1: Per-item cloud merge logic.
Wave 3.2: Physician sharing — token URL + read-only viewer page.
Wave 3.3: Community cloud backend — 6 Supabase tables.

✓ present — absent * partial / with notes

Identity Health records Imaging Family Cost Surgeries Devices Records I/O Community AI / Coaches

🔐Identity & access

Feature	Production	test3
Profile (name, DOB, sex, blood, height)	✓	✓
Emergency contact	✓	✓
Magic-link auth	—	✓
Cloud sync	—	✓
Multi-device convergence (per-item merge)	—	✓

📋Health records

Feature	Production	test3
Vitals — BP / HR / weight / temp / SpO₂ / glucose	✓	✓
Medications	✓	✓ + adherence streaks
Supplements (brand, form, dose, freq)	✓	✓ + adherence streaks
Allergies (severity, reaction)	✓	✓
Conditions	✓	✓
Symptoms journal	✓	✓
Labs (HIGH / LOW flags)	✓	* basic
Appointments	✓	✓

🩻Imaging

Feature	Production	test3
Image type + body region + clinical question	✓	✓
AI analysis (vision)	✓	✓
Severity tagging (flagged / moderate / minor / normal)	—	✓
Severity filter pills	—	✓
Reviewed / unreviewed toggle	—	✓
Follow-up flag	—	✓

👪Family history

Feature	Production	test3
Relative + condition	✓	✓
Status (living / deceased)	✓	✓
Cause of death	*	✓
Hereditary risk (low / moderate / high)	*	✓
Age of onset	*	✓
Auto risk-clustering (2+ relatives OR onset <60)	—	✓

💰Cost tracker / claims

Feature	Production	test3
Cost entries (amount, category, provider)	✓	✓
Insurance covered amount	✓	✓
Claim ID	✓	✓
Status workflow	✓ appeal-focused	✓ pending-focused
Appeal states (Filed / Won / Denied)	✓	—
YTD / monthly / category analytics tabs	*	✓
6-month trend bars	—	✓

🩹Surgeries

Feature	Production	test3
Date + name + hospital + surgeon	✓	✓
Procedure type	✓	✓
Status (Completed / Scheduled / Cancelled)	✓	✓
Anesthesia	✓	✓
Reason	✓	✓
Complications (with red flag)	✓	✓
Follow-up date (with upcoming highlight)	✓	✓

🔌Devices

Feature	Production	test3
Type + model + date + status	✓	✓
Manufacturer	✓	✓
Serial #	✓	✓
Body location	✓	✓
MRI safety flag	✓	✓
Replacement date (overdue flag)	✓	✓
Recall tracking (active / watch / resolved)	✓	✓

📤Records I/O & sharing

Feature	Production	test3
JSON export	✓	✓
JSON import	✓	✓
Print emergency card	✓	✓
QR vCard	✓	✓
Share with physician (token URL)	—	✓
Read-only physician view page	—	✓
Revocable share permissions	—	✓

🤝Community

Feature	Production	test3
Support groups	—	✓ 5 seeded
Posts	—	✓
Reactions (support / celebrate / relate)	—	✓
Challenges + check-ins with streaks	—	✓ 3 seeded
Cloud-backed (Supabase)	—	✓

🤖AI & coaches

Feature	Production	test3
Page-context coach	* limited	✓ per portal
Voice (push-and-hold)	—	✓
Whisper STT	—	✓
TTS reply	—	✓
Vision (pill bottle / label scan)	✓	✓
Avatar-as-mic UI	—	✓

🆕Test3-only portals

Rooms and portals that exist only in test3:

PowerCoach: Strategy + advocacy coaching room.
Practitioner Marketplace: Practitioner sign-ups, browse, profiles (public-only).
My Care: Care-team management (was "Care Team").
Intelligence Platform: Research hub (was "Research & Knowledge"), stats banner + suggestions.
Your Doctors: Sub-orbit in My Health room.
Scan & Analyze: Vision AI portal (8th sub-orbit in My Health).
Know Your Rights: Patient advocacy reference.
Bug Report: Feedback channel.
Cost Tracker: Financial portal with analytics tabs.
Symptom Journal: Symptom log with mental-health + atlas coach extensions.

🧪test3 file map

Purpose	Path
Hub (landing)	index.html
Vault portal	vault.html
Imaging	xrays.html
Family history	family-history.html
Cost tracker	cost-tracker.html
Community	community.html
Practitioner room	practitioner.html
Physician viewer	physician-view.html
Auth library	js/pp_auth.js
Sync library	js/pp_supabase.js
Voice library	js/pp_voice.js
Sharing library	js/pp_share.js
Community library	js/pp_community.js
Chat function (Anthropic proxy)	netlify/functions/chat.js
Transcribe function (Whisper proxy)	netlify/functions/transcribe.js
Deploy mirror	netlify/
This glossary	glossary.html

🏛️Production file map

Purpose	Path
Single-file app	PRODUCTION/patient-power/index.html (15,619 lines)
Chat function	PRODUCTION/patient-power/netlify/functions/chat.js

⚙️Infrastructure

Aspect	Production	test3
URL	patientpower.xyz	beyondmychart.com (alias: rad-fudge-37b7e3.netlify.app)
Netlify site	patientpower-portal	rad-fudge-37b7e3
Supabase project	—	ijlesuzpahhsxtkqxvzz
Deploy method	git auto-deploy	drag-and-drop netlify/
Functions	chat (Anthropic)	chat + transcribe
API keys (env)	ANTHROPIC_API_KEY	ANTHROPIC + OPENAI
CORS preflight	handled before POST	handled before POST

🎯Open gaps

Features that exist in one app but not the other (parity backlog):

test3 → production parity

Lab HIGH / LOW flag rendering
Surgical type / status / anesthesia / reason / complications — DONE 2026-05-25
Device manufacturer + serial # + body location + recall — DONE 2026-05-25

production → test3 parity

Imaging severity triage
Family risk clustering
Cost analytics tabs
Adherence streaks
Cloud sync + multi-device
Physician sharing
Community
Voice / Whisper

Both

Onboarding overlay (test3 pending)
Validation sweep
Demo-mode seeding