The project is for sending e-mail with high deliverability.
Clone the project
git clone [email protected]:gdegirmenci/anaphora.gitBuild docker images and up containers
docker-compose build && docker-compose up -dEnter to the container
docker exec -it anaphora_php bashGive necessary permission to storage
chmod -R 777 storage/Copy .env.example as .env
cp .env.example .envInstall dependencies
composer install
npm ciGenerate application key
php artisan key:generateMigrate schemas
php artisan migrateBuild assets
npm run devStart supervisor and work queue
service supervisor start
php artisan q:wAdd application URL to host file
127.0.0.1 anaphora.localTo configure SendGrid and MailJet credentials, please update related fields from .env
SEND_GRID_API_URL=https://api.sendgrid.com/v3/mail/send
SEND_GRID_API_SECRET=
MAIL_JET_API_URL=https://api.mailjet.com/v3.1/send
MAIL_JET_API_SECRET=To configure primary provider, please update related field from .env
PRIMARY_MAIL_PROVIDER=sendgrid # or mailjetTo configure threshold for failed emails, please update related fields from .env
CIRCUIT_BREAKER_THRESHOLD=3 # default is 3To use application, please visit URL.
http://anaphora.local/If you want to use CLI instead of Vue.js application, then please enter to container and run following command.
$ docker exec -it anaphora_php bash
> php artisan campaign:send {payload: string}Example command:
# should be string as minified JSON
$ docker exec -it anaphora_php bash
> php artisan campaign:send '{ "name": "Very Cool Campaign Name", "subject": "Subject", "from": { "email": "[email protected]", "name": "Gökhan Değirmenci" }, "reply": { "email": "[email protected]", "name": "Gökhan Değirmenci" }, "to": [ { "email": "[email protected]", "name": "First Recipient" }, { "email": "[email protected]", "name": "Second Recipient" } ], "template": "Mail content.", "type": "text" }'To create campaign, type is either text or html
## Create Campaign
curl -X "POST" "http://anaphora.local/api/campaigns/create" \
-H 'Content-Type: application/json' \
-d $'{
"name": "Very Cool Campaign Name",
"subject": "Subject",
"from": {
"email": "[email protected]",
"name": "Gökhan Değirmenci"
},
"reply": {
"email": "[email protected]",
"name": "Gökhan Değirmenci"
},
"to": [
{
"email": "[email protected]",
"name": "First Recipient"
},
{
"email": "[email protected]",
"name": "Second Recipient"
}
],
"template": "Mail content.",
"type": "text"
}'To list campaigns, perPage and page is optional
## Get Campaigns
curl -X "GET" "http://anaphora.local/api/campaigns/get" \
-H 'Content-Type: application/json' \
-d $'{
"perPage": 10,
"page": 1
}'To get statistics and provider statuses
## Get Statistics and Provider Statuses
curl -X "GET" "http://anaphora.local/api/dashboard/get" \
-H 'Content-Type: application/json'Since one of our most important aim is sending e-mails with high deliverability, the project is working with a fallback mechanism, which is structured by Circuit Breaker design pattern. Thanks to this pattern, our service is detecting failures and deciding which provider it should use to send an e-mail.
Mainly, there are 3 statuses for circuits, OPENED HALF-OPENED and CLOSED.
OPENED→ Service is not responding at all.HALF-OPENED→ Service is responding, but it gives error.CLOSED→ Service is responding.
With keeping these status for each provider, the project is handling failures.
After exceeding failed requests for the provider, circuit is opening. By default, threshold is 3.
To close opened circuit, first of all provider should not give any failure for 5 minutes. Meanwhile, status will be opened.
After 10 minutes, if there would not be any failed request, status would be closed again.
# Opening circuit flow
1 FAILED 3 FAILED
CLOSED → HALF-OPENED → OPENED
--------------------------------------
# Closing circuit flow
5 MIN 5 MIN
OPENED → HALF-OPENED → CLOSEDThe project is keeping log for each campaign and provider. From database, logs could be found at campaign_logs table. The relation is HasMany, means a campaign could have more than one log.
Let's assume some scenarios to understand fallback mechanism better.
## SendGrid Circuit: OPENED
## MailJet Circuit: HALF-OPENED
## MailJet Response: False (1st), True (2nd)
If circuit is not opened for MailJet, sending from MailJet for now.## SendGrid Circuit: CLOSED
## MailJet Circuit: HALF-OPENED
## SendGrid Response: True
Sending from SendGrid for now.## SendGrid Circuit: OPENED
## MailJet Circuit: OPENED
## SendGrid Response: N/A since there is no request
Sending from SendGrid for later.## SendGrid Circuit: HALF-OPENED
## MailJet Circuit: HALF-OPENED
## SendGrid Response: False
## MailJet Response: False (1st), False (2nd)
If circuit is opened, sending from MailJet for later.Every provider should have an implementation. To choose provider there is a factory named ProviderServiceFactory. To add new provider, first it should be defined there.
After that, related service should be created under the folder app\Services\Providers\, with extending BaseProviderService
<?php
namespace App\Services\Providers;
use App\Repositories\Campaign\CampaignRepository;
use App\ValueObjects\Email\Email;
/**
* Class FooProviderService
* @package App\Services\Providers
*/
class FooProviderService extends BaseProviderService
{
/**
* FooProviderService constructor.
* @param CampaignRepository $campaignRepository
* @param Email $email
*/
public function __construct(CampaignRepository $campaignRepository, Email $email)
{
parent::__construct($campaignRepository, $email);
}
/**
* @return string
*/
public function getUrl(): string
{
//
}
/**
* @return array
*/
public function getHeaders(): array
{
//
}
/**
* @return Collection
*/
public function getBody(): Collection
{
//
}
/**
* @return string
*/
public function getProvider(): string
{
//
}
}To create an user interface, the project is using Vue.js and Vuetify libraries. Also for HTML/Markdown editor, Vue2Editor is used.
The project is using Vuex to keep states, also fetching datas based on user actions, like clicking menu etc which is handling by VueRouter.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent