# HAD Digital - Help Hub
Project: HAD Digital Version: 1.0.0 Date: 2026-09-05 Owner: Dr Kais Aldabbagh
Getting Started
Running the Application
Option 1: Run the .exe (Recommended)
- Navigate to: 5_Outputs/HAD Digital/
- Double-click: HAD Digital.exe
- Open browser: http://127.0.0.1:8080
- Login: dmin / dmin123
Option 2: Run from Source
- Open terminal
- Navigate to: MVP/
- Run: python app.py
- Open browser: http://127.0.0.1:8080
- Login: dmin / dmin123
User Guides
For Patients
- Login with your credentials
- Report Symptoms - Click "Report Symptoms" and answer questions
- View Timeline - See your care history
- View Treatment Plan - See your current treatment
- Send Messages - Communicate with your care team
For Clinicians
- Login with your credentials
- View Dashboard - See active patients and alerts
- Submit Observations - Record clinical findings
- Manage Alerts - Acknowledge and escalate alerts
- Export Summaries - Generate toxicity reports
For Administrators
- Login with admin credentials
- View All Patients - See all patient data
- Manage Users - Create and manage accounts
- View Audit Log - Track all actions
- Export Data - Generate reports
Troubleshooting
Application Won't Start
Problem: Double-clicking .exe does nothing Solution:
- Check if port 8080 is in use
- Run as administrator
- Check Windows Defender settings
Login Fails
Problem: "Invalid credentials or account locked" Solution:
- Check username and password
- Wait 30 minutes if account is locked
- Use admin account to reset
Database Errors
Problem: "Database not found" Solution:
- Check if data/had.db exists
- Delete had.db to recreate
- Restart application
API Documentation
See 01_System/API_Contract.md for full API documentation.
Key Endpoints
| Endpoint | Method | Description |
|---|---|---|
| /api/login | POST | Login with credentials |
| /api/logout | POST | Logout |
| /api/whoami | GET | Get current user |
| /api/patients | GET | List patients |
| /api/reports | POST/GET | Submit/list reports |
| /api/alerts | GET | List alerts |
| /api/timeline | GET | Get timeline |
| /api/messages | POST/GET | Send/list messages |
Support
For questions or issues:
- Check this help hub
- Review the documentation in 01_System/
- Contact Dr Kais Aldabbagh