# demba-diakhate/mailwo-v3 architecture

> Architecture diagram of the GitHub repository demba-diakhate/mailwo-v3, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/demba-diakhate/mailwo-v3
- Repository: https://github.com/demba-diakhate/mailwo-v3

## Overview

Mailwo V3 is a Laravel email-campaign application. Its evidenced workflow imports contact rows, stores them in cache, lets an operator compose personalized content, then sends mail and reports progress. Authentication is a separate supporting workflow. The README also describes segmentation, campaign scheduling, and performance statistics, but the available tree and excerpts do not show their implementation; those capabilities are noted as documented scope rather than mapped as runtime components.

Main entry points: [`app/Http/Controllers/SendMailController.php`](https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Http/Controllers/SendMailController.php) (Compose and send), [`app/Providers/FortifyServiceProvider.php`](https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Providers/FortifyServiceProvider.php) (Fortify provider), [`routes/web.php`](https://github.com/demba-diakhate/mailwo-v3/blob/main/routes/web.php) (Web routes), [`app/Http/Controllers/ImportCsvController.php`](https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Http/Controllers/ImportCsvController.php) (Contact import)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_campaign["Campaign workflow"]
  node_import["Contact import"]
  node_import_view["Import form"]
  node_csv_service["CSV personalization<br/>[MailCsvService.php]"]
  node_cache[("Application cache")]
  node_compose["Compose and send"]
  node_send_view["Campaign form"]
end

subgraph group_mail["Mail delivery"]
  node_email_template["Email template<br/>[template.blade.php]"]
  node_mailer[("Mail transport")]
  node_queued_job["Queued email job<br/>[SendFileEmail.php]"]
end

subgraph group_auth["Authentication"]
  node_fortify["Fortify provider"]
  node_user_actions["User actions<br/>[CreateNewUser.php]"]
  node_profile_action["Profile updates"]
  node_login_response["Login response<br/>[LoginResponse.php]"]
  node_register_response["Register response"]
  node_user[("User account<br/>[User.php]")]
end

subgraph group_runtime["Application runtime"]
  node_routes["Web routes<br/>[web.php]"]
  node_app_boot["Laravel bootstrap<br/>[app.php]"]
end

node_operator(("Operator"))

node_operator -->|"uses"| node_routes
node_app_boot -->|"loads"| node_routes
node_routes -->|"routes to"| node_import
node_routes -->|"routes to"| node_compose
node_import -->|"renders"| node_import_view
node_compose -->|"renders"| node_send_view
node_import -->|"writes rows"| node_cache
node_compose -->|"reads rows"| node_cache
node_compose -->|"personalizes"| node_csv_service
node_compose -->|"renders"| node_email_template
node_compose -->|"sends through"| node_mailer
node_queued_job -->|"renders"| node_email_template
node_queued_job -->|"sends through"| node_mailer
node_compose -.->|"optional dispatch"| node_queued_job
node_fortify -->|"registers"| node_user_actions
node_fortify -->|"registers"| node_profile_action
node_fortify -->|"binds"| node_login_response
node_fortify -->|"binds"| node_register_response
node_user_actions -->|"creates"| node_user
node_profile_action -->|"updates"| node_user
node_app_boot -.->|"loads provider"| node_fortify

click node_routes "https://github.com/demba-diakhate/mailwo-v3/blob/main/routes/web.php"
click node_import "https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Http/Controllers/ImportCsvController.php"
click node_import_view "https://github.com/demba-diakhate/mailwo-v3/blob/main/resources/views/sendmail/import-csv.blade.php"
click node_csv_service "https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Services/MailCsvService.php"
click node_compose "https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Http/Controllers/SendMailController.php"
click node_send_view "https://github.com/demba-diakhate/mailwo-v3/blob/main/resources/views/sendmail/send-mail.blade.php"
click node_email_template "https://github.com/demba-diakhate/mailwo-v3/blob/main/resources/views/emails/template.blade.php"
click node_queued_job "https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Jobs/SendFileEmail.php"
click node_fortify "https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Providers/FortifyServiceProvider.php"
click node_user_actions "https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Actions/Fortify/CreateNewUser.php"
click node_profile_action "https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Actions/Fortify/UpdateUserProfileInformation.php"
click node_login_response "https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Actions/Fortify/LoginResponse.php"
click node_register_response "https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Actions/Fortify/RegisterResponse.php"
click node_user "https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Models/User.php"
click node_app_boot "https://github.com/demba-diakhate/mailwo-v3/blob/main/bootstrap/app.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_import,node_import_view,node_csv_service,node_cache,node_compose,node_send_view toneBlue
class node_email_template,node_mailer,node_queued_job toneAmber
class node_fortify,node_user_actions,node_profile_action,node_login_response,node_register_response,node_user toneMint
class node_routes,node_app_boot toneRose
class node_operator toneIndigo
```

## Components

### Campaign workflow

- [Contact import](https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Http/Controllers/ImportCsvController.php): `app/Http/Controllers/ImportCsvController.php`
- [Import form](https://github.com/demba-diakhate/mailwo-v3/blob/main/resources/views/sendmail/import-csv.blade.php): `resources/views/sendmail/import-csv.blade.php`
- [CSV personalization](https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Services/MailCsvService.php): `app/Services/MailCsvService.php`
- **Application cache**
- [Compose and send](https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Http/Controllers/SendMailController.php): `app/Http/Controllers/SendMailController.php`
- [Campaign form](https://github.com/demba-diakhate/mailwo-v3/blob/main/resources/views/sendmail/send-mail.blade.php): `resources/views/sendmail/send-mail.blade.php`

### Mail delivery

- [Email template](https://github.com/demba-diakhate/mailwo-v3/blob/main/resources/views/emails/template.blade.php): `resources/views/emails/template.blade.php`
- **Mail transport**
- [Queued email job](https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Jobs/SendFileEmail.php): `app/Jobs/SendFileEmail.php`

### Authentication

- [Fortify provider](https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Providers/FortifyServiceProvider.php): `app/Providers/FortifyServiceProvider.php`
- [User actions](https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Actions/Fortify/CreateNewUser.php): `app/Actions/Fortify/CreateNewUser.php`
- [Profile updates](https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Actions/Fortify/UpdateUserProfileInformation.php): `app/Actions/Fortify/UpdateUserProfileInformation.php`
- [Login response](https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Actions/Fortify/LoginResponse.php): `app/Actions/Fortify/LoginResponse.php`
- [Register response](https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Actions/Fortify/RegisterResponse.php): `app/Actions/Fortify/RegisterResponse.php`
- [User account](https://github.com/demba-diakhate/mailwo-v3/blob/main/app/Models/User.php): `app/Models/User.php`

### Application runtime

- [Web routes](https://github.com/demba-diakhate/mailwo-v3/blob/main/routes/web.php): `routes/web.php`
- [Laravel bootstrap](https://github.com/demba-diakhate/mailwo-v3/blob/main/bootstrap/app.php): `bootstrap/app.php`

### Other components

- **Operator**

## Connections

- Operator → Web routes: uses (evidence: `README.md`)
- Laravel bootstrap → Web routes: loads (evidence: `bootstrap/app.php`)
- Web routes → Contact import: routes to (evidence: `routes/web.php`)
- Web routes → Compose and send: routes to (evidence: `routes/web.php`)
- Contact import → Import form: renders (evidence: `app/Http/Controllers/ImportCsvController.php`)
- Compose and send → Campaign form: renders (evidence: `app/Http/Controllers/SendMailController.php`)
- Contact import → Application cache: writes rows (evidence: `app/Http/Controllers/ImportCsvController.php`)
- Compose and send → Application cache: reads rows (evidence: `app/Http/Controllers/SendMailController.php`)
- Compose and send → CSV personalization: personalizes (evidence: `app/Http/Controllers/SendMailController.php`)
- Compose and send → Email template: renders (evidence: `app/Http/Controllers/SendMailController.php`)
- Compose and send → Mail transport: sends through (evidence: `app/Http/Controllers/SendMailController.php`)
- Queued email job → Email template: renders (evidence: `app/Jobs/SendFileEmail.php`)
- Queued email job → Mail transport: sends through (evidence: `app/Jobs/SendFileEmail.php`)
- Compose and send → Queued email job: optional dispatch (evidence: `app/Http/Controllers/SendMailController.php`)
- Fortify provider → User actions: registers (evidence: `app/Providers/FortifyServiceProvider.php`)
- Fortify provider → Profile updates: registers (evidence: `app/Providers/FortifyServiceProvider.php`)
- Fortify provider → Login response: binds (evidence: `app/Providers/FortifyServiceProvider.php`)
- Fortify provider → Register response: binds (evidence: `app/Providers/FortifyServiceProvider.php`)
- User actions → User account: creates (evidence: `app/Actions/Fortify/CreateNewUser.php`)
- Profile updates → User account: updates (evidence: `app/Actions/Fortify/UpdateUserProfileInformation.php`)
- Laravel bootstrap → Fortify provider: loads provider
