SATHI Documentation¶
Self Reported Assessment and Tracking for Health Insights
Welcome to SATHI, an open-source Django application for collecting, managing, and analyzing patient-reported outcomes (PROMs) and patient-reported experience measures (PREMs).
A comprehensive platform for understanding patient concerns through PROMs and PREMs
Documentation Sections¶
Patient Documentation
Guides for completing questionnaires and viewing your health data
View Patient Docs →Healthcare Worker Documentation
Managing patients, questionnaires, and reviewing clinical results
View HCP Docs →Developer Documentation
Installation, architecture, API reference, and technical guides
View Dev Docs →Key Features¶
For Patients¶
- 📱 Mobile-Responsive Interface
Complete questionnaires on any device with an adaptive, user-friendly interface
- 🌍 Multi-Language Support
Questionnaires available in multiple languages with dynamic font selection
- 🎯 Conditional Logic
Smart questionnaires that adapt based on your responses to reduce burden
- 📊 Personal Health Portal
View your questionnaire history and health data visualizations
- 🎤 Multimedia Support
Audio and video integration for enhanced accessibility
- 🔒 Privacy & Security
Encrypted data with secure authentication and two-factor protection
For Healthcare Providers¶
- 📈 Comprehensive Dashboard
Monitor patient responses with intuitive visualizations and clinical indicators
- 🎯 Clinical Scoring
Track construct scores, composite scores, and item-level responses
- 🚦 Significance Indicators
Color-coded alerts for clinically significant changes and thresholds
- 📊 Interactive Plots
Bokeh-powered visualizations with normative scores and trend analysis
- 👥 Population Aggregation
Compare individual patients against population statistics
- 🏢 Institution Security
Row-level security ensures providers only access their institution’s data
- 📤 Data Export
Export patient responses in CSV format for external analysis
For Questionnaire Designers¶
- 🔐 Role-Based Access
Granular permissions for questionnaire creation and management
- 📝 Item Bank System
Create reusable items and share across multiple questionnaires
- 🎨 Flexible Response Types
Support for Text, Number, Likert scales, and Range selections
- 🧮 Advanced Scoring
Complex equations with variables, conditionals, and composite calculations
- 🌐 Translation Management
Built-in support for multi-language questionnaire content
- 📥 Bulk Operations
CSV import/export for efficient item and questionnaire management
- 🔄 Conditional Display
Rule-based logic to show/hide questions based on previous responses
For Developers¶
- 🏗️ Modern Architecture
Django 6.0, Python 3.13, PostgreSQL with clean separation of concerns
- ⚡ Performance Optimized
Lazy loading, Memcached integration, and optimized database queries
- 🎨 Modern Frontend
HTMX for dynamic updates, TailwindCSS for styling, Django Cotton components
- 🔒 Enterprise Security
Field-level encryption, rate limiting, reCAPTCHA, comprehensive audit logging
- 📱 Progressive Web App
Service workers, offline support, and installable on mobile devices
- 🧪 Testing Framework
Comprehensive test suite with pytest, Selenium, and Locust
- 📚 Complete Documentation
API reference, architecture guides, and development workflows
- 🐳 Deployment Ready
Production configurations for Nginx, Gunicorn, Supervisor, and SSL
Technology Stack¶
- Backend
Django 6.0
Python 3.13
PostgreSQL
Memcached
- Frontend
HTMX (dynamic updates)
TailwindCSS v4 (styling)
django-cotton (components)
Bokeh & Plotly (visualizations)
- Security
django-allauth (authentication)
django-ratelimit (rate limiting)
django-recaptcha (bot protection)
django-secured-fields (encryption)
- Deployment
Nginx (web server)
Gunicorn (WSGI server)
Supervisor (process management)
Let’s Encrypt (SSL certificates)
- Internationalization
django-parler (model translations)
gettext (UI translations)