1. Overview | Notion

Project Description

Aura is a personal medical records tracker — a full-stack web application for managing visits, treatments, lab results, vaccinations, health metrics, and more. All UI labels are in Ukrainian. Timezone: Europe/Kyiv.

The app is designed as a single-user system with JWT authentication, running as a Progressive Web App installable on any device.

Goals

Centralize all personal medical data in one place
Track doctor visits with documents, body region tagging, and expense tracking
Monitor treatment courses with automatic status calculation
Record lab results with biomarker trends and reference ranges
Track health metrics (blood pressure, heart rate, weight, etc.) with charts
Manage vaccinations with dose tracking and due-date alerts
Provide a calendar view of medical history with appointment scheduling and .ics export
Deliver push notification reminders for upcoming events
Display weather and environmental data (UV, AQI, geomagnetic storms)
Work offline as a PWA with service worker caching

Tech Stack

Layer	Technologies
Frontend	Vue.js 3.5, TypeScript 5.9, PrimeVue 4.5 (Aura preset), Pinia, Vue Router, Vite 7, Chart.js 4.5
Backend	Python 3.14+, FastAPI 0.115+, SQLAlchemy 2.0+ (async), Pydantic v2, Alembic
Database	PostgreSQL 15+, psycopg v3 (async)
Auth	JWT tokens (PyJWT), bcrypt password hashing
Push	pywebpush, VAPID (auto-generated), APScheduler (PostgreSQL-backed persistence, advisory locks)
PWA	vite-plugin-pwa, Workbox, custom service worker
Weather	SkyPulse (UV, AQI, geomagnetic storms, circadian light)
Calendar	FullCalendar 6 (Vue 3 adapter), icalendar (Python .ics generation)
Testing	pytest, pytest-asyncio (114 tests)
Infra	Docker Compose, GitHub Actions CI