# ISPSC Medical Records System - User Guide

## 🏥 Welcome to ISPSC Medical Records

This is a complete medical record and certification system for school clinic operations.

## 📱 Getting Started

### For Students

1. **Register** (`register.html`)
   - Fill in your personal information
   - Upload a selfie photo
   - If applicable, provide maternal health information
   - Agree to data collection consent

2. **Login** (`login.html`)
   - Use your ID number and password
   - Complete 2-factor authentication if prompted

3. **Dashboard** (`dashboard.html`)
   - View your medical request status
   - See issued certificates
   - Request new medical certificates
   - Track morbidity and health trends

4. **Request Certificate** (`medical-request.html`)
   - Select the medical tests you need
   - Upload supporting documents for each test
   - Specify the date range for the certification
   - Submit for admin review

5. **View Certificate** (`request-detail.html` or `certificates.html`)
   - Check your request status in real-time
   - View admin comments
   - Follow the approval timeline
   - Download your issued certificate

### For Employees/HR

1. **Login** (`login.html`)
   - Use your employee credentials
   - Role determines access level

2. **Employee Dashboard** (`employee-dashboard.html`)
   - View team health analytics
   - Track sick leave trends
   - Filter by department
   - Monitor health status by staff member

### For Admin/Medical Officers

1. **Login** (`login.html`)
   - Use your admin credentials
   - 2FA verification required

2. **Admin Workbench** (`admin-workbench.html`)
   - View queue of pending medical requests
   - Compare student selfie with reference photo
   - Review medical test attachments
   - Add comments and notes
   - Approve requests and issue certificates
   - Request additional information from students
   - Reject requests with reason

## 📋 Request Process Timeline

```
Student Creates Request
    ↓
Request Appears in Admin Queue
    ↓
Admin Reviews (ID Photo Comparison)
    ↓
Admin Verifies Test Attachments
    ↓
Admin Takes Action:
  • ✓ Approve & Issue → Certificate Ready
  • ✗ Reject → Request Back to Student
  • ? Request Info → Student Uploads More Files
    ↓
Student Views Certificate
    ↓
Student Downloads Certificate
```

## 🔐 Security Features

- **Two-Factor Authentication (2FA)**
  - Required for admin and staff login
  - Use Google Authenticator or similar app

- **Session Management**
  - Auto-logout after inactivity
  - Secure token storage
  - Automatic redirect on unauthorized access

- **Data Protection**
  - HTTPS/TLS encryption
  - Bearer token authentication
  - Password hashing on backend

## 📊 Key Features by Role

### Student Features
- ✅ Personal profile management
- ✅ Multi-step registration wizard
- ✅ Selfie upload with validation
- ✅ Medical request creation
- ✅ Per-test file upload
- ✅ Request status tracking
- ✅ Certificate download
- ✅ Morbidity dashboard

### Employee/HR Features
- ✅ Team health analytics
- ✅ Sick leave tracking
- ✅ Department-based reporting
- ✅ 6-month trend analysis
- ✅ Team member status monitoring

### Admin/Medical Officer Features
- ✅ Request queue management
- ✅ SLA tracking (48-hour goal)
- ✅ Side-by-side image verification
- ✅ File attachment review
- ✅ Comment threads
- ✅ Approval workflow
- ✅ Certificate issuance
- ✅ Request rejection/modification

## 🛠️ Technical Details

### Supported Browsers
- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+

### File Size Limits
- Selfie photo: 5MB max
- Medical test attachment: 10MB max
- Supported formats: JPG, PNG, PDF

### Image Requirements
- Selfie: Minimum 200x200 pixels
- Quality: Clear, well-lit, front-facing
- Format: JPG or PNG

## ⏰ SLA & Processing Times

- **Standard Processing**: 48 hours (2 business days)
- **Priority**: Upon request (additional fees may apply)
- **Emergency**: Contact clinic directly

## 📞 Support

For issues or questions:
- Email: support@clinic.edu
- Phone: +1-555-CLINIC-1
- Chat: Available on dashboard (9 AM - 5 PM)

## 🔄 Account Recovery

### Forgot Password
1. Click "Forgot Password" on login page
2. Enter your ID number
3. Check email for reset link
4. Create new password

### Lost Authenticator App
1. Contact admin with backup codes
2. Use recovery code to login
3. Reset 2FA settings
4. Re-configure authenticator app

### Lost Certificates
- All certificates available in "Certificates" section
- Can redownload at any time
- Archived certificates available via support

## 📱 Mobile Access

- Fully responsive design
- Works on smartphones and tablets
- Optimized touch interface
- Works on mobile browsers

## ⚙️ Settings & Preferences

Access from Dashboard:
- Notification preferences
- Email settings
- Privacy settings
- Language preference
- Theme (Light/Dark mode)

## 📚 Data & Privacy

- All personal data is encrypted
- Complies with HIPAA/GDPR
- Regular security audits
- Data retention policy available
- Delete account request available

## 🎯 Common Tasks

### Upload a Selfie
1. Go to Registration or Profile
2. Click "Upload Photo"
3. Take or select photo
4. Crop if needed
5. Confirm upload
6. Photo must be minimum 200x200 pixels

### Request Multiple Tests
1. Go to "Medical Request"
2. Select tests from categories
3. Upload at least 1 file per test
4. Status badge shows "Complete" when ready
5. Submit when all tests have files

### Monitor Request Status
1. Dashboard shows all requests
2. Click "View" to see details
3. Timeline shows current stage
4. Status badge indicates approval stage
5. Comments show admin feedback

### Download Certificate
1. Go to "Certificates" page
2. Click "Download" button
3. Certificate downloads as PDF
4. Can print directly
5. Can email to others

## 🚀 Troubleshooting

### Can't Login
- Verify ID number is correct
- Check caps lock is off
- Clear browser cache
- Use supported browser
- Try incognito/private mode

### 2FA Code Not Working
- Verify device time is correct
- Try next code (changes every 30 seconds)
- Use backup codes if available
- Contact admin for recovery

### File Upload Fails
- Check file size (max limits listed)
- Verify file format (JPG, PNG, PDF only)
- Try different file
- Clear cache and retry
- Check internet connection

### Can't See Dashboard
- Verify logged in (check top right)
- Allow page to fully load
- Refresh page (Ctrl+R)
- Clear browser cache
- Try different browser

## 📖 Additional Resources

- [Privacy Policy](https://clinic.edu/privacy)
- [Terms of Service](https://clinic.edu/terms)
- [Data Protection](https://clinic.edu/data-protection)
- [FAQ](https://clinic.edu/faq)
- [Contact Us](https://clinic.edu/contact)

---

**System Status**: [Check System Status](https://clinic.edu/status)

Last Updated: 2024