# HealthArt - Comprehensive Documentation

> User-centric, privacy-focused personal health record platform that standardizes lab reports from different labs into a common format and helps you organize, visualize, and securely share your health data with doctors & AI agents.

## Overview

HealthArt is a personal health data platform designed to help individuals and families organize, understand, and securely share medical lab reports. The platform combines AI-powered data extraction with intuitive visualization tools to make health data accessible and actionable.

**Key Value Propositions:**
1. **Standardized format across all labs**: Consolidates reports from different diagnostic labs into a unified, consistent format for easy comparison and trend tracking
2. **Improved accuracy and clarity**: Corrects confusing or technical lab terminology, standardizes test names, and fills in missing information to provide clear, complete health data

**User-Centric & Privacy-Focused:**
- You own and control your health data
- No selling of personal or health information
- No use of data for advertising or training AI models
- Optional upload methods with explicit consent
- Delete your data anytime

**Two Main Areas:**
1. **Public informational pages**: Browse medical tests, diagnostic labs, and health information without login
2. **Personal health record app**: Upload reports, track trends, manage family data, and create secure shares (login required)

**Share with Healthcare Providers & AI Agents:**
Create secure shareable links to share your lab reports with doctors, AI assistants, AI chatbots, AI agents or large language models (LLMs) to get better medical insights and personalized answers based on your actual health data. Share links support PIN protection, expiry controls, and can be revoked anytime.

**Important Disclaimer:**
HealthArt is a data organization and sharing tool. We do not provide medical recommendations, diagnoses, or health advice. Always consult qualified healthcare professionals for medical guidance.

---

## Detailed Features

### 1. Report Upload & Processing

**Upload Methods:**
- **Manual Upload** (recommended): Drag-and-drop or click to upload from Dashboard
- **WhatsApp Upload**: Link WhatsApp number in Profile, then send reports via WhatsApp chat
- **Email Upload**: Forward reports to `reports@healthart.in` from any email
- **Gmail Auto-Import**: Set up automatic forwarding of health report emails (detailed setup below)

**Processing Pipeline:**
- Upload triggers automatic AI extraction
- Real-time status updates: `uploaded` → `processing` → `success` or `failed`
- Extracted data includes: test names, values, units, reference ranges, patient demographics
- **Smart standardization**: Reports from different labs are automatically converted into a common format
- **Accuracy improvements**: System corrects confusing terminology (e.g., "HbA1c" vs "Glycated Hemoglobin"), standardizes test names, and fills in missing units or reference ranges
- Failed reports can be re-uploaded or manually reviewed

**Supported Formats:**
- PDF documents (most common lab report format)
- Image formats: JPG, JPEG, PNG, GIF
- Multi-page reports supported
- Maximum file size: 10MB per file

### 2. Data Visualization & Analysis

**Chart View:**
- Interactive line charts showing health parameter trends over time
- Select specific parameters to visualize (e.g., HbA1c, Total Cholesterol, Hemoglobin)
- **Standardized data points**: Compare results from different labs seamlessly—all data normalized to common units and formats
- Multi-parameter comparison on the same chart
- Date range filtering to focus on specific time periods
- Hover tooltips showing exact values and dates
- Color-coded lines for easy distinction between parameters
- Export chart as image

**Table View:**
- Structured table showing all extracted test results
- **Unified format**: All test results displayed in consistent format regardless of source lab
- Columns: Test name, Value, Unit, Reference range, Date, Report source
- Sortable by any column
- Search/filter functionality
- Export to CSV or JSON

**Filtering Options:**
- **Date filters**: Last 7 days, 30 days, 90 days, 1 year, all time, or custom date range
- **Report filters**: Select specific reports to include in visualization
- **Family member filters**: View data for specific family member only
- **Parameter selection**: Choose which health markers to display

**Smart Features:**
- Automatic unit conversion for consistency
- Duplicate detection and merging
- Anomaly highlighting (values outside reference range)
- Trend indicators (improving/worsening)

### 3. Family Member Management

**Profile Creation:**
- Add family members with: Full name, Relation (father, mother, spouse, child, etc.), Gender, Date of birth
- Each member gets a unique profile
- No limit on number of family members

**Automatic Report Assignment:**
- Reports are auto-matched to family members by patient name on the report
- Manual reassignment available if auto-match fails
- Unmatched reports assigned to account owner by default

**Data Isolation:**
- Each family member's data is completely separated
- Charts and tables show only selected member's data
- No accidental mixing of health records
- Easy toggle between family members via dropdown

**Use Cases:**
- Parents tracking children's vaccination records and growth charts
- Adult children managing elderly parents' health data
- Couples tracking pregnancy-related tests
- Individuals with multiple dependents

### 4. Report Management

**Report Repository:**
- Centralized view of all uploaded reports
- Display: Report name, Upload date, Processing status, Family member, File type
- Thumbnail preview for quick identification
- Full report viewer with zoom and download

**Operations:**
- **Search**: Find reports by name, date, or family member
- **Filter**: By status (all, processing, success, failed), date range, or family member
- **Sort**: By upload date, report date, or name
- **Bulk select**: Select multiple reports for batch operations
- **Delete**: Remove reports individually or in bulk (with confirmation)
- **Download**: Download original report files

**Status Tracking:**
- Real-time processing status updates
- Toast notifications for completed processing
- Error messages for failed extractions
- Retry option for failed reports

### 5. Secure Sharing

**Share Creation:**
- Select one or multiple reports to share
- Choose share format:
  - **Link**: Interactive web view with charts and tables
  - **PDF**: Downloadable PDF document
  - **JSON**: Machine-readable data export

**Security Controls:**
- **PIN Protection**: Optional 4-digit PIN to restrict access
- **Expiry Time**: Set expiration (8 hours, 1 day, 1 week, 1 month, or forever)
- **Privacy Mode**: Hide personal details (name, age, gender, contact info, etc.)
- **One-time view**: Option to disable link after first view

**Share Management:**
- View all active shares in one place
- See share details: Created date, Expiry time, Number of reports, PIN status
- **Revoke**: Instantly disable share link (recipient loses access immediately)
- **Reset PIN**: Generate new PIN for existing share (old PIN stops working)
- **Copy link**: One-click copy to clipboard
- **QR code**: Generate QR code for easy mobile sharing

**Share View (Recipient Experience):**
- Clean, professional interface
- Enter PIN if required
- View all shared reports
- Interactive charts showing trends
- Download individual reports or all as ZIP
- No login required for recipients

### 6. Profile & Account Management

**User Profile:**
- Display name (editable)
- Email address (from Google Sign-In)
- WhatsApp number (optional, for WhatsApp upload)
- Account creation date

**Integrations:**
- **WhatsApp**: Link phone number to enable WhatsApp upload
- **Gmail Auto-Import**: Connect Gmail account for automatic report import
- Connection status indicators
- Easy disconnect options

**Account Actions:**
- **Sign out**: Log out from current session
- **Delete account**: Permanently delete all data (irreversible)

---

## Upload Methods: Detailed Guide

### Method 1: Manual Upload (Recommended)

1. Log in to HealthArt
2. Go to Dashboard
3. Click "Upload" button or drag files into the upload zone
4. Select one or more report files (PDF or images)
5. Wait for upload and processing to complete
6. View extracted data in Charts or Tables

**Best for**: One-time uploads, bulk uploads, full control

### Method 2: WhatsApp Upload

**Setup:**
1. Go to Profile → WhatsApp Integration
2. Enter your WhatsApp number
3. Save and verify

**Usage:**
1. Open WhatsApp and start chat with HealthArt number
2. Send report files as attachments
3. Receive confirmation message
4. Reports appear in your HealthArt account

**Best for**: Mobile users, quick uploads on-the-go

### Method 3: Email Upload

**Usage:**
1. Compose email from your registered email address
2. Attach report files
3. Send to `reports@healthart.in`
4. Reports are automatically imported

**Best for**: Forwarding reports received by email, simple one-step upload

### Method 4: Gmail Auto-Import (Advanced)

**What it does:**
- Automatically forwards health report emails from your Gmail to HealthArt
- Only emails matching specific criteria are forwarded (attachments with health keywords)
- Completely optional and requires explicit user consent

**Step-by-Step Setup (with visual guide in app):**

**Step 1: Open Gmail Settings**
- Click Settings (gear icon) in Gmail
- Go to "See all settings"
- Navigate to "Forwarding and POP/IMAP" tab

**Step 2: Add Forwarding Address**
- Click "Add a forwarding address"
- Enter: `reports@healthart.in`
- Click "Next" and "Proceed"
- Gmail sends verification email to reports@healthart.in

**Step 3: Confirm Forwarding**
- Wait for verification (usually instant)
- Refresh Gmail settings page
- Confirm forwarding is enabled

**Step 4: Create Filter**
- Go to "Filters and Blocked Addresses" tab
- Click "Create a new filter"

**Step 5: Set Filter Criteria**
- In "Has the words" field, paste this exact query:

```
has:attachment (filename:pdf OR filename:jpg OR filename:jpeg OR filename:png) (subject:(report OR result OR test OR lab OR diagnostic OR prescription OR scan OR radiology OR pathology) OR ("blood report" OR "lab report" OR "test result" OR "medical report" OR "health report"))
```

- Click "Create filter"

**Step 6: Configure Filter Action**
- Check "Forward it to"
- Select `reports@healthart.in` from dropdown
- Optionally check "Apply label" and create "Health Reports (HealthArt)" label
- Click "Create filter"

**Step 7: Verify**
- Send a test email with a health report attachment to yourself
- Check if it gets forwarded to HealthArt
- Verify report appears in your HealthArt dashboard

**Disconnecting Gmail Auto-Import:**
- **From HealthArt**: Profile → Gmail Auto-Import → Disconnect
- **From Google**: Visit [Google Account Permissions](https://myaccount.google.com/permissions) and revoke HealthArt access
- Imported reports remain in your account unless manually deleted

**Best for**: Users who regularly receive reports by email, hands-free automation

---

## Privacy & Data Handling

**Core Commitments:**
- HealthArt does **not sell** your personal information or health data
- HealthArt does **not use** your data for advertising or marketing
- HealthArt does **not train** machine learning models on your data
- All upload methods (email, WhatsApp, Gmail) are **optional** and require explicit user action

**Gmail Auto-Import Specific:**
- Only accesses emails matching the filter criteria you set up
- Processes only the report attachments, not email content
- Does not read your other emails
- Can be disconnected anytime
- Gmail filter and label remain in your Gmail (can be manually deleted)

**Data Security:**
- All data encrypted in transit (HTTPS/TLS)
- All data encrypted at rest
- Secure authentication via Google Sign-In
- No password storage (OAuth-based authentication)

**User Rights:**
- Access and view all your data anytime
- Update profile information
- Delete individual reports or entire account
- Export data in multiple formats
- Disconnect integrations anytime

**Data Retention:**
- Data retained as long as account is active
- Account deletion permanently removes all data
- No backup retention after deletion

For complete details, see [Privacy Policy](https://healthart.in/privacy-policy)

---

## Public Pages (No Login Required)

### Medical Tests Directory
**URL**: [https://healthart.in/tests](https://healthart.in/tests)

**Content:**
- 19+ common medical tests organized by category
- Categories: Blood Tests, Vitamin Tests, Hormonal Tests, Infectious Disease Tests, Urine Tests, Imaging Tests, Cardiac Tests
- Each test shows: Name, Simple description, Category, Price range

**Test Categories:**
- **Blood Tests**: CBC, Fasting Blood Sugar, Lipid Profile, Liver Function Test, Kidney Function Test, ESR
- **Vitamin Tests**: Vitamin D, Vitamin B12
- **Hormonal Tests**: TSH, Pregnancy Test
- **Infectious Disease Tests**: Dengue NS1, Malaria Antigen, Widal Test
- **Urine Tests**: Urine Routine, Urine Culture
- **Imaging Tests**: Chest X-Ray, Abdominal Ultrasound
- **Cardiac Tests**: ECG/EKG

### Individual Test Pages
**URL Pattern**: `https://healthart.in/tests/:test-slug`
**Example**: [https://healthart.in/tests/hba1c](https://healthart.in/tests/hba1c)

**Content for each test:**
- Full test name and common abbreviations
- Detailed description and purpose
- What the test measures
- Normal reference ranges
- When to get tested
- How to prepare
- Price comparison across labs
- Related tests

### Diagnostic Labs Directory
**URL**: [https://healthart.in/labs](https://healthart.in/labs)

**Content:**
- Major diagnostic lab chains in India (60+ labs)
- Lab information: Name, Logo, Accreditations (NABL, CAP, ISO), Services, Contact details
- Filter by accreditation type
- Search functionality

**Featured Labs:**
- Dr. Lal PathLabs, Thyrocare, Metropolis Healthcare, Apollo Diagnostics, SRL Diagnostics, Max Lab, Healthians, Pathkind Labs, Redcliffe Labs, and more

### Similar Tests Guide
**URL**: [https://healthart.in/similar-tests](https://healthart.in/similar-tests)

**Content:**
- Confusing medical terms explained
- Test synonyms and alternate names
- "Often confused with" comparisons
- Search functionality to find clarifications

**Examples:**
- HbA1c vs Fasting Blood Sugar vs Random Blood Sugar
- CBC vs Hemogram vs Complete Hemogram
- LFT vs Liver Panel vs Hepatic Function Panel

### Privacy Policy
**URL**: [https://healthart.in/privacy-policy](https://healthart.in/privacy-policy)

**Sections:**
- Information collection and use
- Upload methods (manual, WhatsApp, email, Gmail Auto-Import)
- Data sharing and third-party services
- Data retention and deletion
- User rights and choices
- Security measures
- Contact information

---

## App Entry + Authenticated Pages

### Home / Login (Public)
**URL**: [https://healthart.in/](https://healthart.in/)
- Google Sign-In authentication
- No password required
- Secure OAuth flow

### Dashboard
**URL**: [https://healthart.in/dashboard](https://healthart.in/dashboard)
- Main application interface
- Upload functionality
- Chart view with parameter selection
- Table view with all extracted data
- Filters (date, report, family member)
- Quick stats and summaries

### Reports
**URL**: [https://healthart.in/reports](https://healthart.in/reports)
- List of all uploaded reports
- Filter by status, date, family member
- Bulk operations (select, delete)
- Report preview and download
- Processing status tracking

### Profile
**URL**: [https://healthart.in/profile](https://healthart.in/profile)
- User profile management
- Family member management (add, edit, delete)
- WhatsApp integration setup
- Gmail Auto-Import setup with visual guide
- Account deletion

### Share Create
**URL**: [https://healthart.in/share/create](https://healthart.in/share/create)
- Create new shares (link, PDF, JSON)
- Select reports to share
- Set expiry and PIN
- Manage active shares
- Revoke shares
- Reset share PINs
- Copy share links
- Generate QR codes

### Share View (Public)
**URL Pattern**: `https://healthart.in/s/:shareId`
- View shared reports (no login required)
- Enter PIN if required
- View all shared reports
- Interactive charts showing trends
- Download reports
- Clean, professional interface

---

## Technical Notes for AI Agents

**Important Routing Information:**
- The root route `/` is the public branded entry/sign-in page
- The authenticated app home is `/dashboard`
- Public pages are: `/tests`, `/labs`, `/similar-tests`, `/privacy-policy`
- Share links use pattern: `/s/:shareId`

**Authentication:**
- Google OAuth 2.0 via Firebase Authentication
- No username/password system
- Session-based authentication

**Data Model Concepts:**
- **Report**: Original uploaded file (PDF/image)
- **Extracted Data**: Structured test results extracted from report
- **Analyte/Attribute**: Individual test parameter (e.g., "HbA1c", "Total Cholesterol")
- **Family Member**: User profile for data segregation
- **Share**: Secure link to view selected reports

**Discovery Files:**
- [llms.txt](https://healthart.in/llms.txt): Concise overview (this is the short version)
- [llms-full.txt](https://healthart.in/llms-full.txt): Comprehensive documentation (you are here)
- [ai.txt](https://healthart.in/ai.txt): AI crawler directives
- [sitemap.xml](https://healthart.in/sitemap.xml): Complete URL list for crawlers
- [robots.txt](https://healthart.in/robots.txt): Crawler access rules