How simple-login/app works
SimpleLogin protects users’ identities with email aliases: users configure aliases and mailboxes through the web app or API, then incoming mail is processed and forwarded through the alias system. The graph also preserves account linking, OAuth, subscription, contact/reverse-alias, and admin capabilities documented or represented in the repository. Relationships are limited to README statements and source-index references or excerpts; unsampled implementation details are not inferred.
Main entry points: models.py Domain Models · account_linking.py Account Linking · alias_utils.py Alias Management · email_handler.py Mail Ingress
Components 24
User Entry Points
- Web App
server.py - User API
app/api/views/alias.py - Authentication
app/api/views/auth.py - Dashboard
app/dashboard/views/alias_contact_manager.py - OAuth Authorization
app/oauth/views/authorize.py
Identity and Aliases
- Alias Management
app/alias_utils.py - Reverse Aliases
app/contact_utils.py - Account Linking
app/account_linking.py
Email Processing
- Mail Ingress
email_handler.py - Email Handling
app/email_utils.py - Unsubscribe Handling
app/handler/unsubscribe_handler.py - Mail Sending
app/mail_sender.py
Accounts and Services
- Mailbox Management
app/mailbox_utils.py - Custom Domains
app/custom_domain_utils.py - Subscriptions
app/payments/paddle.py - Proton Integration
app/proton/proton_client.py
Shared Platform
- Domain Models
app/models.py - PostgreSQL
app/db.py - Event Dispatch
app/events/event_dispatcher.py - Audit Logs
app/user_audit_log_utils.py - Object Storage
app/s3.py - Admin Tools
app/admin/index.py
Other components
- User
- Remote Mail System
Connections 27
- User → Web App: uses web app
- User → User API: uses API
- Remote Mail System → Mail Ingress: delivers email
- Web App → Dashboard: serves dashboard
- User API → Alias Management: manages aliases
- Authentication → Account Linking: links accounts
app/account_linking.py - User → Authentication: authenticates
app/api/views/auth.py - User → OAuth Authorization: authorizes app
app/oauth/views/authorize.py - Dashboard → Reverse Aliases: manages contacts
app/dashboard/views/alias_contact_manager.py - Mail Ingress → Alias Management: resolves aliases
email_handler.py - Mail Ingress → Email Handling: processes email
email_handler.py - Email Handling → Mail Sending: sends mail
app/email_utils.py - Unsubscribe Handling → Alias Management: changes alias status
app/handler/unsubscribe_handler.py - Unsubscribe Handling → Mail Sending: sends notice
app/handler/unsubscribe_handler.py - Alias Management → Domain Models: uses domain models
app/alias_utils.py - Reverse Aliases → Domain Models: uses domain models
app/contact_utils.py - Account Linking → Domain Models: updates accounts
app/account_linking.py - Account Linking → Event Dispatch: dispatches events
app/account_linking.py - Account Linking → Audit Logs: records activity
app/account_linking.py - Domain Models → PostgreSQL: persists records
app/models.py - Mailbox Management → Domain Models: manages mailboxes
app/models.py - Custom Domains → Domain Models: manages domains
app/models.py - Subscriptions → Domain Models: updates plans
app/payments/paddle.py - Subscriptions → Event Dispatch: dispatches changes
- Proton Integration → Account Linking: links Proton users
app/proton/proton_client.py - Admin Tools → Domain Models: administers records
app/admin/index.py - Domain Models → Object Storage: stores file metadata
app/models.py