How restufrmnsyh/saferelief works
SafeRelief is a desktop disaster-relief coordination app for admins and volunteers. Its main workflow is dongle, password and face authentication, followed by a role-specific workspace for victim records, encrypted chat, photo documentation, reports and aid-distribution tracking. The UI pages invoke authentication, storage and cryptographic services; SQLite access is centralized in the database layer. The README documents the major capabilities, while some feature-page implementations were not sampled, so their specific internal call paths are not asserted.
Main entry points: main_window.py Main window · secure_store.py Secure data access · login_page.py Login screen · volunteers.py Volunteer operations
Components 29
Application and UI
- Application startup
app.py - Main window
ui/main_window.py - Login screen
ui/login_page.py - Workspace shell
ui/workspace.py
Identity and Access
- Dongle verification
auth/dongle.py - Password authentication
auth/login.py - Face authentication
auth/face_auth.py - Session and keys
auth/session.py - Volunteer operations
auth/volunteers.py
Relief Operations
- Dashboard
ui/dashboard_page.py - Victim records
ui/victims_page.py - Encrypted chat
ui/chat_page.py - Photo documentation
ui/photo_page.py - Photo metadata
ui/photo_metadata.py - Report files
ui/files_page.py - Encrypted downloads
ui/encrypted_downloads.py - Aid distribution
ui/aid_page.py - Activity audit
ui/activity_log_page.py - Volunteer management
ui/volunteer_management_page.py
Security and Persistence
- Secure data access
database/secure_store.py - SQLite access
database/db.py - Key management
crypto/keys.py - AES encryption
crypto/aes_module.py - Chat encryption
crypto/super_encrypt.py - File encryption
crypto/chacha_module.py - LSB steganography
crypto/stego_lsb.py - Aid blockchain
crypto/blockchain.py - Password and hashes
crypto/hashing.py
Other components
- Admin or volunteer
Connections 34
- Admin or volunteer → Application startup: starts app
README.md - Application startup → Main window: opens window
app.py - Main window → Login screen: routes login
ui/main_window.py - Login screen → Dongle verification: checks dongle
ui/login_page.py - Login screen → Password authentication: checks password
ui/login_page.py - Login screen → Face authentication: checks face
ui/login_page.py - Login screen → Session and keys: starts session
ui/login_page.py - Session and keys → Key management: derives keys
auth/session.py - Password authentication → Password and hashes: verifies password
auth/login.py - Main window → Workspace shell: shows workspace
ui/main_window.py - Main window → Dashboard: opens page
ui/main_window.py - Main window → Victim records: opens page
ui/main_window.py - Main window → Volunteer management: opens page
ui/main_window.py - Main window → Encrypted chat: opens page
ui/main_window.py - Main window → Photo documentation: opens page
ui/main_window.py - Main window → Report files: opens page
ui/main_window.py - Main window → Aid distribution: opens page
ui/main_window.py - Main window → Activity audit: opens page
ui/main_window.py - Volunteer management → Volunteer operations: manages accounts
ui/volunteer_management_page.py - Volunteer operations → Dongle verification: provisions dongle
auth/volunteers.py - Volunteer operations → Face authentication: stores face data
auth/volunteers.py - Victim records → Secure data access: accesses records
ui/victims_page.py - Dashboard → Secure data access: loads summary
ui/dashboard_page.py - Secure data access → SQLite access: queries database
database/secure_store.py - Secure data access → AES encryption: encrypts fields
database/secure_store.py - Encrypted chat → Chat encryption: encrypts messages
README.md - Photo documentation → LSB steganography: embeds metadata
ui/photo_page.py - Photo documentation → Photo metadata: uses metadata
ui/photo_page.py - Report files → File encryption: encrypts reports
ui/files_page.py - Report files → Encrypted downloads: opens downloads
ui/files_page.py - Encrypted downloads → File encryption: decrypts reports
ui/encrypted_downloads.py - Aid distribution → Secure data access: records distributions
README.md - Secure data access → Aid blockchain: adds aid blocks
database/secure_store.py - Secure data access → SQLite access: persists blocks
database/secure_store.py