# Health Insight Assistant - Complete Project Structure
```
health-insight-assistant/
├── backend/
│ ├── app/
│ │ ├── __init__.py
│ │ ├── [Link] # FastAPI application entry
│ │ ├── [Link] # Configuration settings
│ │ ├── [Link] # Database connection
│ │ │
│ │ ├── models/
│ │ │ ├── __init__.py
│ │ │ ├── [Link] # User model
│ │ │ ├── health_record.py # Health record model
│ │ │ └── [Link] # Report model
│ │ │
│ │ ├── schemas/
│ │ │ ├── __init__.py
│ │ │ ├── [Link] # User Pydantic schemas
│ │ │ ├── health_record.py # Health record schemas
│ │ │ └── [Link] # Report schemas
│ │ │
│ │ ├── api/
│ │ │ ├── __init__.py
│ │ │ ├── [Link] # Dependencies
│ │ │ └── v1/
│ │ │ ├── __init__.py
│ │ │ ├── endpoints/
│ │ │ │ ├── __init__.py
│ │ │ │ ├── [Link] # Authentication endpoints
│ │ │ │ ├── health_records.py # Health records endpoints
│ │ │ │ ├── [Link] # Analysis endpoints
│ │ │ │ └── [Link] # Report generation
│ │ │ └── [Link]
│ │ │
│ │ ├── core/
│ │ │ ├── __init__.py
│ │ │ ├── [Link] # Security utilities
│ │ │ ├── reference_ranges.py # Medical reference ranges
│ │ │ └── medical_knowledge.py # Medical knowledge base
│ │ │
│ │ ├── services/
│ │ │ ├── __init__.py
│ │ │ ├── analysis_service.py # Health data analysis
│ │ │ ├── explanation_service.py # AI explanation generation
│ │ │ ├── validation_service.py # Data validation
│ │ │ ├── trend_service.py # Trend analysis
│ │ │ └── pdf_parser_service.py # PDF parsing
│ │ │
│ │ ├── utils/
│ │ │ ├── __init__.py
│ │ │ ├── [Link] # Logging configuration
│ │ │ └── [Link] # Helper functions
│ │ │
│ │ └── tests/
│ │ ├── __init__.py
│ │ ├── test_analysis.py
│ │ ├── test_validation.py
│ │ └── test_api.py
│ │
│ ├── alembic/ # Database migrations
│ │ ├── versions/
│ │ └── [Link]
│ │
│ ├── [Link]
│ ├── Dockerfile
│ └── .[Link]
│
├── frontend/
│ ├── public/
│ │ ├── [Link]
│ │ └── [Link]
│ │
│ ├── src/
│ │ ├── components/
│ │ │ ├── Auth/
│ │ │ │ ├── [Link]
│ │ │ │ └── [Link]
│ │ │ │
│ │ │ ├── Dashboard/
│ │ │ │ ├── [Link]
│ │ │ │ └── [Link]
│ │ │ │
│ │ │ ├── DataInput/
│ │ │ │ ├── [Link]
│ │ │ │ ├── [Link]
│ │ │ │ └── [Link]
│ │ │ │
│ │ │ ├── Results/
│ │ │ │ ├── [Link]
│ │ │ │ ├── [Link]
│ │ │ │ ├── [Link]
│ │ │ │ └── [Link]
│ │ │ │
│ │ │ └── Common/
│ │ │ ├── [Link]
│ │ │ ├── [Link]
│ │ │ ├── [Link]
│ │ │ └── [Link]
│ │ │
│ │ ├── services/
│ │ │ ├── [Link] # API client
│ │ │ ├── [Link] # Auth service
│ │ │ └── [Link] # Health data service
│ │ │
│ │ ├── utils/
│ │ │ ├── [Link]
│ │ │ └── [Link]
│ │ │
│ │ ├── hooks/
│ │ │ ├── [Link]
│ │ │ └── [Link]
│ │ │
│ │ ├── context/
│ │ │ └── [Link]
│ │ │
│ │ ├── [Link]
│ │ ├── [Link]
│ │ └── [Link]
│ │
│ ├── [Link]
│ ├── [Link]
│ ├── [Link]
│ └── Dockerfile
│
├── [Link]
├── .gitignore
├── [Link]
└── docs/
├── [Link]
├── [Link]
└── USER_GUIDE.md
```
## Quick Start Commands
```bash
# Clone and setup
git clone <your-repo>
cd health-insight-assistant
# Backend setup
cd backend
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r [Link]
cp .[Link] .env
# Edit .env with your configuration
# Run migrations
alembic upgrade head
# Start backend
uvicorn [Link]:app --reload
# Frontend setup (in new terminal)
cd frontend
npm install
npm run dev
# Docker setup (alternative)
docker-compose up --build
```
## Environment Variables (.env)
```env
# Backend
DATABASE_URL=postgresql://user:password@localhost:5432/health_insight
SECRET_KEY=your-secret-key-here-change-in-production
ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=30
# Anthropic API (for AI explanations)
ANTHROPIC_API_KEY=your-anthropic-api-key
# Optional
REDIS_URL=redis://localhost:6379
ENVIRONMENT=development
```
Next, I'll provide the complete code for all major files!