How tud8951/cloud-mail works
Cloud Mail is a Cloudflare Workers-based email service with a Vue client. Users sign in, manage email accounts, read received messages and attachments, compose and send mail, and use administrative features such as user/role management, settings, and analytics. The client routes pages through request modules to the Worker API; backend services apply business rules and use D1, KV, and R2 or external providers. The README documents major capabilities, while sampled source confirms selected service calls and dependencies; unsampled links are omitted or marked unverified.
Main entry points: email.js Inbound mail · email-service.js Email operations · account-service.js Email accounts · user-service.js User management
Components 28
Vue client
- Client shell
mail-vue/src/main.js - Page routing
mail-vue/src/router/index.js - Mailbox views
mail-vue/src/views/email/index.vue - Compose mail
mail-vue/src/layout/write/index.vue - Admin views
mail-vue/src/views/user/index.vue - Analytics view
mail-vue/src/views/analysis/index.vue - API requests
mail-vue/src/request/email.js
Worker application
- Worker entry
mail-worker/src/index.js - API endpoints
mail-worker/src/api - Identity and permissions
mail-worker/src/security
Mail domain services
- Inbound mail
mail-worker/src/email/email.js - Email operations
mail-worker/src/service/email-service.js - Email accounts
mail-worker/src/service/account-service.js - User management
mail-worker/src/service/user-service.js - Roles and limits
mail-worker/src/service/role-service.js - OAuth login
mail-worker/src/service/oauth-service.js - Site settings
mail-worker/src/service/setting-service.js - Mail analytics
mail-worker/src/service/analysis-service.js - Attachments
mail-worker/src/service/att-service.js
Storage and integrations
- D1 database
- Cloudflare KV
- Cloudflare R2
- Resend
- Telegram or mail forward
- Workers AI
- Turnstile
- Linux.do OAuth
Other components
- Mail user
Connections 39
- Mail user → Client shell: uses
README.md - Client shell → Page routing: loads routes
mail-vue/src/main.js - Mail user → Mailbox views: manages mail
README.md - Mail user → Compose mail: composes mail
README.md - Mail user → Admin views: administers
README.md - Mail user → Analytics view: views analytics
README.md - Mailbox views → API requests: requests mail
- Compose mail → API requests: submits mail
- Admin views → API requests: requests admin
- Analytics view → API requests: requests metrics
- API requests → API endpoints: calls API
- API endpoints → Worker entry: registered by
- Worker entry → Inbound mail: dispatches inbound
mail-worker/src/index.js - Inbound mail → Email operations: stores received mail
mail-worker/src/email/email.js - Inbound mail → Email accounts: resolves accounts
mail-worker/src/email/email.js - Inbound mail → Site settings: reads settings
mail-worker/src/email/email.js - Inbound mail → Attachments: handles attachments
mail-worker/src/email/email.js - Inbound mail → Telegram or mail forward: forwards notifications
mail-worker/src/email/email.js - Inbound mail → Workers AI: identifies codes
mail-worker/src/email/email.js - Email operations → Resend: sends mail
mail-worker/src/service/email-service.js - Email operations → Attachments: saves attachments
mail-worker/src/service/email-service.js - Email operations → Email accounts: queries accounts
mail-worker/src/service/email-service.js - Email operations → Roles and limits: checks recipients
mail-worker/src/service/email-service.js - Email accounts → User management: checks user
mail-worker/src/service/account-service.js - Email accounts → Email operations: deletes mail
mail-worker/src/service/account-service.js - User management → Email accounts: loads account counts
mail-worker/src/service/user-service.js - User management → Email operations: loads mail counts
mail-worker/src/service/user-service.js - User management → Roles and limits: loads permissions
mail-worker/src/service/user-service.js - OAuth login → User management: looks up user
mail-worker/src/service/oauth-service.js - OAuth login → Linux.do OAuth: exchanges OAuth
mail-worker/src/service/oauth-service.js - Site settings → Cloudflare R2: stores background
mail-worker/src/service/setting-service.js - Site settings → Cloudflare KV: caches settings
mail-worker/src/service/setting-service.js - Worker entry → Mail analytics: loads analytics
mail-worker/src/index.js - Inbound mail → D1 database: stores mail data
- Email operations → D1 database: reads and writes
- Email accounts → D1 database: reads and writes
- Roles and limits → D1 database: reads and writes
- OAuth login → D1 database: reads and writes
- Mail user → Turnstile: verification