How cy035/cloud-mail works
Cloud Mail is a Cloudflare-based multi-account email service. Users access mail and administration through a responsive Vue interface; the Worker provides account, email, attachment, permission, settings, and analytics capabilities, with D1/KV/R2 and external mail or verification integrations. The main flow is user action → frontend request → Worker API and business services → stored or delivered mail. Some UI/API wiring is documented only at product level; those relationships are marked unverified rather than inferred from filenames.
Main entry points: email.js Mail processing · api HTTP APIs · email-service.js Email operations · orm.js D1 database
Components 22
Mail interface
- Vue application
mail-vue/src/main.js - Mail views
mail-vue/src/views - Admin views
mail-vue/src/views - API requests
mail-vue/src/request
Worker runtime
- Worker entry
mail-worker/src/index.js - HTTP APIs
mail-worker/src/api
Mail capabilities
- Accounts and access
mail-worker/src/service/account-service.js - Mail processing
mail-worker/src/email/email.js - Email operations
mail-worker/src/service/email-service.js - Attachments
mail-worker/src/service/att-service.js - Roles and permissions
mail-worker/src/service/role-service.js - Analytics
mail-worker/src/service/analysis-service.js - Site settings
mail-worker/src/service/setting-service.js
Data and integrations
- D1 database
mail-worker/src/entity/orm.js - Cloudflare KV
mail-worker/src/service/setting-service.js - Object storage
mail-worker/src/service/r2-service.js - Resend delivery
mail-worker/src/service/resend-service.js - Turnstile
mail-worker/src/service/turnstile-service.js - Workers AI
mail-worker/src/service/ai-service.js - Telegram push
mail-worker/src/service/telegram-service.js - Webhook push
mail-worker/src/service/webhook-service.js
Other components
- Mail user
Connections 38
- Mail user → Vue application: uses
README.md - Vue application → Mail views: renders
- Vue application → Admin views: renders
- Mail views → API requests: requests
- Admin views → API requests: requests
- API requests → HTTP APIs: calls
- HTTP APIs → Worker entry: routes through
- Worker entry → Mail processing: registers
mail-worker/src/index.js - Worker entry → Analytics: imports
mail-worker/src/index.js - Worker entry → Accounts and access: imports
mail-worker/src/index.js - Worker entry → Email operations: imports
mail-worker/src/index.js - HTTP APIs → Accounts and access: dispatches
- HTTP APIs → Email operations: dispatches
- HTTP APIs → Analytics: dispatches
- HTTP APIs → Site settings: dispatches
- HTTP APIs → Roles and permissions: dispatches
- Mail processing → Email operations: uses
mail-worker/src/email/email.js - Mail processing → Accounts and access: uses
mail-worker/src/email/email.js - Mail processing → Site settings: uses
mail-worker/src/email/email.js - Mail processing → Attachments: uses
mail-worker/src/email/email.js - Mail processing → Telegram push: notifies
mail-worker/src/email/email.js - Mail processing → Webhook push: notifies
mail-worker/src/email/email.js - Mail processing → Workers AI: uses
mail-worker/src/email/email.js - Accounts and access → D1 database: queries
mail-worker/src/service/account-service.js - Email operations → D1 database: queries
mail-worker/src/service/email-service.js - Email operations → Attachments: saves files
mail-worker/src/service/email-service.js - Attachments → Object storage: stores objects
mail-worker/src/service/att-service.js - Attachments → D1 database: records metadata
mail-worker/src/service/att-service.js - Roles and permissions → D1 database: queries
mail-worker/src/service/role-service.js - Site settings → D1 database: reads settings
mail-worker/src/service/setting-service.js - Site settings → Cloudflare KV: caches settings
mail-worker/src/service/setting-service.js - Site settings → Object storage: manages background
mail-worker/src/service/setting-service.js - Email operations → Resend delivery: sends mail
README.md - Accounts and access → Turnstile: verifies humans
mail-worker/src/service/account-service.js - Mail processing → Telegram push: pushes received mail
README.md - Mail processing → Webhook push: pushes received mail
README.md - Mail processing → Workers AI: recognizes codes
README.md - Analytics → D1 database: reports data