JointWise Patient Education Bot

A HIPAA-conscious patient education assistant for orthopedic and sports medicine, built with FastAPI and vanilla JavaScript.

Features

• 🤖 AI-powered patient education chatbot
• 🏥 Orthopedic & sports medicine knowledge base
• 💬 Conversation history with context
• 💳 Subscription management (Stripe-ready)
• 📱 Responsive mobile-friendly design
• 🔒 JWT authentication
• ⚠️ Mandatory medical disclaimers

Tech Stack

• Backend: Python 3.10+, FastAPI, SQLAlchemy, JWT
• Frontend: Vanilla HTML/CSS/JavaScript
• Database: SQLite (easily swappable to PostgreSQL)
• AI: OpenAI API (configurable)

Quick Start

1. Install Dependencies

cd jointwise
pip install -r requirements.txt

2. Configure Environment

Create a .env file:

# Required for AI responses
OPENAI_API_KEY=sk-your-openai-api-key

# Security
SECRET_KEY=your-super-secret-key-change-in-production

# Optional: Stripe for subscriptions
STRIPE_SECRET_KEY=sk_test_xxx
STRIPE_PRICE_ID=price_xxx

3. Run the Application

# Start backend
cd backend
uvicorn main:app --reload --host 0.0.0.0 --port 8000

# In another terminal, start frontend server
cd frontend
python -m http.server 8080

4. Access the App

• Frontend: http://localhost:8080
• API Docs: http://localhost:8000/docs

Project Structure

jointwise/
├── backend/
│   ├── main.py              # FastAPI application
│   ├── config.py            # Configuration settings
│   ├── models.py            # SQLAlchemy models
│   ├── database.py          # Database connection
│   ├── routers/
│   │   ├── auth.py          # Authentication endpoints
│   │   ├── chat.py          # Chat endpoints
│   │   └── subscription.py  # Subscription endpoints
│   ├── services/
│   │   └── chat_service.py  # OpenAI integration
│   └── utils/
│       └── security.py      # Security utilities
├── frontend/
│   ├── index.html            # Main application
│   ├── css/
│   │   └── styles.css       # Styles
│   └── js/
│       └── app.js           # Frontend logic
├── docs/
│   ├── api.md               # API documentation
│   ├── system_prompt.md      # JointWise system prompt
│   ├── disclaimer.md         # Medical disclaimer
│   └── compliance.md         # Compliance documentation
├── requirements.txt
├── README.md
└── deploy.md

API Endpoints

Authentication

• POST /api/auth/register - Register new user
• POST /api/auth/token - Login and get JWT token
• GET /api/auth/me - Get current user info

Chat

• POST /api/chat/chat - Send message and get AI response
• GET /api/chat/conversations - List all conversations
• GET /api/chat/conversations/{id} - Get conversation with messages
• DELETE /api/chat/conversations/{id} - Delete conversation

Subscription

• GET /api/subscription/status - Get subscription status
• POST /api/subscription/subscribe - Create Stripe checkout
• POST /api/subscription/cancel - Cancel subscription
• POST /api/subscription/webhook - Stripe webhook handler

System Prompt

JointWise uses a carefully crafted system prompt that:

• Defines the AI's role as an educator (not a diagnostician)
• Sets a warm, professional tone
• Lists capabilities and limitations
• Enforces mandatory medical disclaimers
• Handles sensitive topics appropriately

See docs/system_prompt.md for the full prompt.

Medical Disclaimer

Every AI response includes:

⚠️ This content is for educational purposes only and does not constitute medical advice. Please consult your doctor for specific medical guidance.

Subscription Tiers

Feature	Free	Premium ($9.99/mo)
Daily messages	5	Unlimited
Conversation history	✓	✓
Rehabilitation plans	-	✓
Priority support	-	✓

Security Features

• Password hashing with bcrypt
• JWT token authentication
• CORS configuration
• Input validation
• SQL injection prevention

Compliance (HIPAA Awareness)

• User data stored securely
• Audit logging capability
• PHI anonymization helpers
• Data export capability

Note: This is an MVP. For full HIPAA compliance, additional measures are needed (encryption at rest, secure backups, BAA with cloud providers, etc.).

Development

Run Tests

pytest backend/tests/ -v

Code Style

flake8 backend/
black backend/

License

MIT License - See LICENSE file for details.

---

Built with ❤️ for better patient education.