How mhdbadr/mail-system works
Mail Support System is a full-stack shared-mailbox application: authenticated support staff process imported customer messages as tickets, reply through a shared mailbox, and also use internal mail. The main path runs from the Angular workspace through authenticated REST operations to backend mail/ticket services and persistent state; IMAP import and SMTP sending support the external-mail lifecycle. The README documents the system integrations and behavior; source excerpts show selected query, reply, ticket, identity, and storage responsibilities, so unsampled implementation links are omitted or marked unverified.
Main entry points: MailController.kt Mail endpoints · SupportTicketLifecycleService.kt Ticket lifecycle · app.ts Angular application · MailQueryService.kt Mailbox queries
Components 29
Web workspace
- Angular application
frontend/src/app/app.ts - Mail workspace
frontend/src/pages/mails - Ticket workspace
frontend/src/pages/tickets - Mail API client
frontend/src/services/mails/mails-service.ts - Ticket API client
frontend/src/services/tickets/tickets-service.ts
Identity and access
- OIDC client
frontend/src/services/auth/auth-service.ts - Keycloak
- API security
backend/src/main/kotlin/de/thm/mni/backend/security/SecurityConfig.kt - User profiles
backend/src/main/kotlin/de/thm/mni/backend/user/User.kt
Mail workflows
- Mail endpoints
backend/src/main/kotlin/de/thm/mni/backend/mail/MailController.kt - Mailbox queries
backend/src/main/kotlin/de/thm/mni/backend/mail/MailQueryService.kt - Recipient records
backend/src/main/kotlin/de/thm/mni/backend/mailrecord/MailRecordService.kt - Mail records
backend/src/main/kotlin/de/thm/mni/backend/mail/Mail.kt - Internal replies
backend/src/main/kotlin/de/thm/mni/backend/mail/internal/InternalReplyService.kt - Support replies
backend/src/main/kotlin/de/thm/mni/backend/mail/external/SupportReplyService.kt - IMAP import
backend/src/main/kotlin/de/thm/mni/backend/mail/external/MailImportService.kt - IMAP polling
backend/src/main/kotlin/de/thm/mni/backend/imap/IMAPService.kt - SMTP sender
backend/src/main/kotlin/de/thm/mni/backend/smtp/SMTPService.kt - Recipient record store
backend/src/main/kotlin/de/thm/mni/backend/mailrecord/MailRecordRepository.kt
Support tickets
- Ticket endpoints
backend/src/main/kotlin/de/thm/mni/backend/ticket/SupportTicketController.kt - Ticket lifecycle
backend/src/main/kotlin/de/thm/mni/backend/ticket/SupportTicketLifecycleService.kt - Ticket operations
backend/src/main/kotlin/de/thm/mni/backend/ticket/SupportTicketService.kt - Ticket state
backend/src/main/kotlin/de/thm/mni/backend/ticket/SupportTicket.kt
Persistence and attachments
- Attachment metadata
backend/src/main/kotlin/de/thm/mni/backend/attachment/Attachment.kt - File storage
backend/src/main/kotlin/de/thm/mni/backend/storage/FileStorageService.kt - S3 attachment store
backend/src/main/kotlin/de/thm/mni/backend/storage/s3/S3AttachmentStorage.kt
Other components
- Support staff
- Support mailbox
- SeaweedFS storage
Connections 30
- Support staff → Angular application: uses
- Angular application → OIDC client: starts sign-in
- OIDC client → Keycloak: authenticates
- Angular application → Mail workspace: routes to
- Angular application → Ticket workspace: routes to
- Mail workspace → Mail API client: requests mail
- Ticket workspace → Ticket API client: requests tickets
- Mail API client → Mail endpoints: calls API
- Ticket API client → Ticket endpoints: calls API
- Keycloak → API security: issues tokens
- Mail endpoints → Mailbox queries: delegates queries
- Mailbox queries → Mail records: reads mails
backend/src/main/kotlin/de/thm/mni/backend/mail/MailQueryService.kt - Mailbox queries → Recipient records: queries recipients
backend/src/main/kotlin/de/thm/mni/backend/mail/MailQueryService.kt - Recipient records → Recipient record store: reads and writes
backend/src/main/kotlin/de/thm/mni/backend/mailrecord/MailRecordService.kt - Mail endpoints → Internal replies: handles internal mail
- Mail endpoints → Support replies: handles support replies
- Support replies → Ticket lifecycle: attaches reply
backend/src/main/kotlin/de/thm/mni/backend/mail/external/SupportReplyService.kt - Ticket endpoints → Ticket lifecycle: changes ticket state
- Ticket lifecycle → Ticket operations: generates ticket code
backend/src/main/kotlin/de/thm/mni/backend/ticket/SupportTicketLifecycleService.kt - Ticket lifecycle → Ticket state: persists transitions
backend/src/main/kotlin/de/thm/mni/backend/ticket/SupportTicketLifecycleService.kt - IMAP polling → IMAP import: polls messages
backend/src/main/kotlin/de/thm/mni/backend/mail/external/MailImportService.kt - IMAP import → Support mailbox: imports messages
- IMAP import → Ticket lifecycle: associates incoming mail
backend/src/main/kotlin/de/thm/mni/backend/mail/external/MailImportService.kt - Support replies → SMTP sender: sends replies
- SMTP sender → Support mailbox: delivers mail
- Mail endpoints → File storage: manages attachments
- File storage → S3 attachment store: delegates storage
backend/src/main/kotlin/de/thm/mni/backend/storage/FileStorageService.kt - S3 attachment store → SeaweedFS storage: stores binaries
- File storage → Attachment metadata: returns metadata
- API security → User profiles: resolves identity