ses-dashboard 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c7165bdb98b1bf82aa3b6a65e7346101bc9792eb81e7b81fd8c1c9128865697f
+  data.tar.gz: 520bc27a98c191b442b307bb7878cc4566883d2567db36373ea62396e867748b
+SHA512:
+  metadata.gz: c77bbac1e82db66182c2bd4141d8ab66ea9e9fb267dc0f33b0a082add3af7bf5ed72bdfb7c6bb2dd772d5db4ae19db61b120681d8f6d8001816ed90dbb8f7dfc
+  data.tar.gz: 8e3f511a3be5108a96247ff6fb42cfa05aed17003637f9d43c92863b6629a653cfd71ce74f5606952750a0655018fbfb01c8d06eedfd8f89cfdd6dce7f2b12d9

data/Dockerfile

@@ -0,0 +1,8 @@
+FROM ruby:4
+
+WORKDIR /usr/src/app
+COPY . /usr/src/app
+
+RUN bundle install
+
+CMD ["bundle", "exec", "rspec"]

data/README.md

@@ -0,0 +1,238 @@
+# SES Dashboard
+
+A mountable Rails engine that provides a real-time dashboard for Amazon SES, tracking email delivery, bounces, complaints, opens, and clicks via SNS webhooks.
+
+```mermaid
+graph TB
+    subgraph Host["Host Rails App"]
+        Routes["routes.rb<br/>mount SesDashboard::Engine"]
+        Initializer["initializer<br/>SesDashboard.configure"]
+    end
+
+    subgraph Engine["SesDashboard Engine"]
+        direction TB
+        subgraph Controllers
+            DC["DashboardController"]
+            PC["ProjectsController"]
+            EC["EmailsController"]
+            WC["WebhooksController"]
+            TC["TestEmailsController"]
+        end
+
+        subgraph Auth["Authentication Adapters"]
+            None[":none"]
+            Devise[":devise"]
+            CF[":cloudflare"]
+            Custom["Custom adapter"]
+        end
+
+        subgraph Core["Core Library (lib/)"]
+            Client["Client<br/>AWS SES SDK wrapper"]
+            WP["WebhookProcessor<br/>SNS message parser"]
+            SA["StatsAggregator<br/>Dashboard statistics"]
+            Pag["Paginatable"]
+        end
+
+        subgraph Models
+            Project["Project<br/>name, token"]
+            Email["Email<br/>status, opens, clicks"]
+            Event["EmailEvent<br/>event_type, event_data"]
+        end
+
+        subgraph Services
+            WEP["WebhookEventPersistor"]
+        end
+    end
+
+    subgraph AWS["Amazon Web Services"]
+        SES["SES API<br/>send quota, statistics,<br/>send email"]
+        SNS["SNS Topic<br/>email event notifications"]
+    end
+
+    Routes --> Controllers
+    Initializer --> Auth
+    DC --> SA
+    EC --> Pag
+    TC --> Client
+    WC -->|"POST /webhook/:token"| WP
+    WP --> WEP
+    WEP --> Models
+    Client --> SES
+    SNS -->|"HTTP POST"| WC
+    SA --> Models
+    Project -->|has_many| Email
+    Email -->|has_many| Event
+
+    style Engine fill:#f0f4ff,stroke:#3366cc
+    style AWS fill:#fff3e0,stroke:#ff9800
+    style Host fill:#e8f5e9,stroke:#4caf50
+```
+
+## Features
+
+- **Real-time webhook processing** -- receives SNS notifications for delivery, bounce, complaint, open, click, reject, and rendering failure events
+- **Per-project dashboards** -- stat cards, email volume charts (Chart.js), and paginated activity logs
+- **Pluggable authentication** -- ships with Devise, Cloudflare Zero Trust, and no-auth adapters; bring your own with any object that responds to `#authenticate(request)`
+- **CSV/JSON export** -- export filtered email activity from any project
+- **Test email sending** -- send test emails directly from the dashboard via the SES API
+- **Status state machine** -- unidirectional email status transitions (sent -> delivered/bounced/etc.)
+- **Database agnostic** -- works with SQLite, PostgreSQL, and MySQL
+- **Lightweight pagination** -- no external pagination gem required
+
+## Installation
+
+Add the gem to your Gemfile:
+
+```ruby
+gem "ses_dashboard"
+```
+
+Then run:
+
+```bash
+bundle install
+rails ses_dashboard:install:migrations
+rails db:migrate
+```
+
+## Mounting
+
+Mount the engine in your `config/routes.rb`:
+
+```ruby
+Rails.application.routes.draw do
+  mount SesDashboard::Engine, at: "/ses-dashboard"
+end
+```
+
+The dashboard is now available at `/ses-dashboard`.
+
+## Configuration
+
+Create an initializer at `config/initializers/ses_dashboard.rb`:
+
+```ruby
+SesDashboard.configure do |c|
+  # AWS credentials (optional — the SDK credential chain is used by default:
+  # SSO, IAM roles, instance profiles, environment variables, etc.)
+  c.aws_region            = "us-east-1"
+  c.aws_access_key_id     = ENV["AWS_ACCESS_KEY_ID"]
+  c.aws_secret_access_key = ENV["AWS_SECRET_ACCESS_KEY"]
+  c.endpoint              = nil  # set to "http://localhost:4566" for LocalStack
+
+  # Authentication adapter — :none, :devise, :cloudflare, or a custom object
+  c.authentication_adapter = :devise
+
+  # Cloudflare Zero Trust (only needed when using :cloudflare adapter)
+  c.cloudflare_team_domain = "myteam.cloudflareaccess.com"
+  c.cloudflare_aud         = "your-application-aud"
+
+  # Dashboard behaviour
+  c.per_page       = 25     # rows per page in the activity log
+  c.time_zone      = "UTC"  # timezone for chart date grouping
+  c.test_email_from = "noreply@example.com"
+
+  # Caching & security
+  c.cache_enabled        = true   # cache SES API responses in memory
+  c.verify_sns_signature = true   # validate SNS signatures (enable in production)
+end
+```
+
+## Authentication
+
+Every controller action (except the webhook endpoint) runs through the configured authentication adapter.
+
+| Adapter | Value | Notes |
+|---|---|---|
+| None | `:none` | Open access -- suitable for development |
+| Devise | `:devise` | Calls `authenticate_user!` via Warden |
+| Cloudflare Zero Trust | `:cloudflare` | Validates `CF_Authorization` JWT against JWKS |
+| Custom | any object | Must respond to `#authenticate(request)` returning truthy/falsy |
+
+```ruby
+# Example custom adapter
+class ApiKeyAuth
+  def authenticate(request)
+    request.headers["X-Api-Key"] == Rails.application.credentials.dashboard_key
+  end
+end
+
+SesDashboard.configure do |c|
+  c.authentication_adapter = ApiKeyAuth.new
+end
+```
+
+## SNS Webhook Setup
+
+Each project gets a unique webhook URL displayed on its dashboard page:
+
+```
+https://yourapp.com/ses-dashboard/webhook/<project-token>
+```
+
+To connect it to SES:
+
+1. In the **AWS SNS console**, create a topic (or use an existing one).
+2. Add a **subscription** with protocol **HTTPS** and the webhook URL above. The engine auto-confirms the subscription.
+3. In the **SES console**, configure a **Configuration Set** with an SNS destination pointing to that topic. Select the event types you want to track (Send, Delivery, Bounce, Complaint, Open, Click, Reject, Rendering Failure).
+
+The webhook endpoint authenticates via the project token in the URL and does not require a session.
+
+## Database Schema
+
+The engine creates three tables (prefixed `ses_dashboard_`):
+
+| Table | Key Columns |
+|---|---|
+| `ses_dashboard_projects` | `name`, `token` (unique, auto-generated), `description` |
+| `ses_dashboard_emails` | `project_id`, `message_id` (unique), `source`, `destination` (JSON), `subject`, `status`, `opens`, `clicks`, `sent_at` |
+| `ses_dashboard_email_events` | `email_id`, `event_type`, `event_data` (JSON), `occurred_at` |
+
+Email statuses: `sent`, `delivered`, `bounced`, `complained`, `rejected`, `failed`.
+
+## Development
+
+### Prerequisites
+
+- Docker & Docker Compose (for system specs and local AWS)
+- Ruby >= 3.0
+
+### Setup
+
+```bash
+git clone <repo-url>
+cd ses-dashboard
+docker compose run --rm web bundle install
+```
+
+### Running Tests
+
+```bash
+# All tests (unit + controller + system) inside Docker
+docker compose run --rm web bundle exec rspec
+
+# Unit and controller tests only (no Docker needed)
+bundle exec rspec spec/models spec/controllers spec/ses_dashboard
+
+# Single test file
+bundle exec rspec spec/models/ses_dashboard/email_spec.rb
+
+# Single example by line number
+bundle exec rspec spec/models/ses_dashboard/email_spec.rb:15
+```
+
+### Docker Compose Services
+
+| Service | Purpose | Ports |
+|---|---|---|
+| `localstack` | Local AWS (SES + SNS) | 4566 |
+| `chrome` | Selenium standalone Chromium | 4444 (WebDriver), 7900 (noVNC -- watch tests live) |
+| `web` | Runs the test suite | 4001 (Puma) |
+
+### Watching System Tests
+
+Open http://localhost:7900 in your browser (no password) to watch Chrome execute system specs in real time via noVNC.
+
+## License
+
+MIT

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/app/assets/javascripts/ses_dashboard/application.js

@@ -0,0 +1,126 @@
+/* SES Dashboard — vanilla JS, no framework required */
+
+(function () {
+  "use strict";
+
+  // ── Chart initialisation ─────────────────────────────────────────────
+  function initChart() {
+    var el = document.getElementById("chart-data");
+    var canvas = document.getElementById("activity-chart");
+    if (!el || !canvas || typeof Chart === "undefined") return;
+
+    var data;
+    try { data = JSON.parse(el.textContent); } catch (e) { return; }
+
+    new Chart(canvas.getContext("2d"), {
+      type: "line",
+      data: {
+        labels: data.labels,
+        datasets: [{
+          label: "Emails sent",
+          data: data.data,
+          borderColor: "#0d6efd",
+          backgroundColor: "rgba(13,110,253,.08)",
+          borderWidth: 2,
+          pointRadius: 3,
+          fill: true,
+          tension: 0.3
+        }]
+      },
+      options: {
+        responsive: true,
+        maintainAspectRatio: true,
+        plugins: {
+          legend: { display: false },
+          tooltip: { mode: "index", intersect: false }
+        },
+        scales: {
+          x: { grid: { display: false } },
+          y: { beginAtZero: true, ticks: { precision: 0 } }
+        }
+      }
+    });
+  }
+
+  // ── Copy to clipboard ────────────────────────────────────────────────
+  function copyToClipboard(text) {
+    if (navigator.clipboard) {
+      navigator.clipboard.writeText(text).catch(function () {
+        fallbackCopy(text);
+      });
+    } else {
+      fallbackCopy(text);
+    }
+  }
+
+  function fallbackCopy(text) {
+    var ta = document.createElement("textarea");
+    ta.value = text;
+    ta.style.position = "fixed";
+    ta.style.opacity = "0";
+    document.body.appendChild(ta);
+    ta.focus();
+    ta.select();
+    try { document.execCommand("copy"); } catch (e) { /* ignore */ }
+    document.body.removeChild(ta);
+  }
+
+  // ── Copy buttons ─────────────────────────────────────────────────────
+  function initCopyButtons() {
+    document.querySelectorAll("[data-copy]").forEach(function (btn) {
+      btn.addEventListener("click", function () {
+        var text = btn.getAttribute("data-copy");
+        copyToClipboard(text);
+        var original = btn.textContent;
+        btn.textContent = "Copied!";
+        setTimeout(function () { btn.textContent = original; }, 1500);
+      });
+    });
+  }
+
+  // ── Event raw data toggles ───────────────────────────────────────────
+  function initEventToggles() {
+    document.querySelectorAll(".event-data-toggle").forEach(function (btn) {
+      btn.addEventListener("click", function () {
+        var raw = btn.closest(".event-item").querySelector(".event-raw");
+        if (!raw) return;
+        raw.classList.toggle("visible");
+        btn.textContent = raw.classList.contains("visible") ? "Hide raw" : "Show raw";
+      });
+    });
+  }
+
+  // ── Filter form reset ─────────────────────────────────────────────────
+  function initFilterReset() {
+    var resetBtn = document.getElementById("filter-reset");
+    if (!resetBtn) return;
+    resetBtn.addEventListener("click", function () {
+      var form = resetBtn.closest("form");
+      if (!form) return;
+      form.querySelectorAll("input[type=text], input[type=date], select").forEach(function (el) {
+        el.value = "";
+      });
+      form.submit();
+    });
+  }
+
+  // ── Confirm destructive actions ───────────────────────────────────────
+  function initConfirmLinks() {
+    document.querySelectorAll("[data-confirm]").forEach(function (el) {
+      el.addEventListener("click", function (e) {
+        if (!window.confirm(el.getAttribute("data-confirm"))) {
+          e.preventDefault();
+        }
+      });
+    });
+  }
+
+  // ── Boot ─────────────────────────────────────────────────────────────
+  document.addEventListener("DOMContentLoaded", function () {
+    initChart();
+    initCopyButtons();
+    initEventToggles();
+    initFilterReset();
+    initConfirmLinks();
+  });
+})();

data/app/assets/stylesheets/ses_dashboard/application.css

@@ -0,0 +1,226 @@
+/* SES Dashboard — standalone stylesheet (no Bootstrap dependency) */
+
+:root {
+  --color-bg:          #f8f9fa;
+  --color-surface:     #ffffff;
+  --color-border:      #dee2e6;
+  --color-text:        #212529;
+  --color-text-muted:  #6c757d;
+  --color-primary:     #0d6efd;
+  --color-primary-dk:  #0a58ca;
+  --color-sent:        #6c757d;
+  --color-delivered:   #198754;
+  --color-bounced:     #dc3545;
+  --color-complained:  #fd7e14;
+  --color-rejected:    #dc3545;
+  --color-failed:      #6f42c1;
+  --nav-height:        56px;
+}
+
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+body {
+  font-family: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
+  font-size: 14px;
+  color: var(--color-text);
+  background: var(--color-bg);
+}
+
+a { color: var(--color-primary); text-decoration: none; }
+a:hover { text-decoration: underline; }
+
+/* ── Navigation ────────────────────────────────────────── */
+.ses-nav {
+  position: sticky;
+  top: 0;
+  z-index: 100;
+  display: flex;
+  align-items: center;
+  gap: 1.5rem;
+  height: var(--nav-height);
+  padding: 0 1.5rem;
+  background: var(--color-text);
+  color: #fff;
+}
+
+.ses-nav-brand {
+  font-weight: 700;
+  font-size: 1rem;
+  color: #fff;
+  letter-spacing: .025em;
+}
+
+.ses-nav a {
+  color: rgba(255,255,255,.8);
+  font-size: .875rem;
+}
+.ses-nav a:hover { color: #fff; text-decoration: none; }
+.ses-nav a.active { color: #fff; font-weight: 600; }
+
+.ses-nav-spacer { flex: 1; }
+
+/* ── Layout ─────────────────────────────────────────────── */
+.ses-container {
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 1.5rem;
+}
+
+/* ── Flash messages ─────────────────────────────────────── */
+.flash { padding: .75rem 1rem; border-radius: .375rem; margin-bottom: 1rem; font-size: .875rem; }
+.flash-notice  { background: #d1e7dd; color: #0a3622; border: 1px solid #a3cfbb; }
+.flash-alert   { background: #f8d7da; color: #58151c; border: 1px solid #f1aeb5; }
+
+/* ── Cards ──────────────────────────────────────────────── */
+.card {
+  background: var(--color-surface);
+  border: 1px solid var(--color-border);
+  border-radius: .5rem;
+  padding: 1.25rem;
+}
+
+.card-title {
+  font-size: .75rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: .05em;
+  color: var(--color-text-muted);
+  margin-bottom: .5rem;
+}
+
+.card-value {
+  font-size: 2rem;
+  font-weight: 700;
+  line-height: 1;
+}
+
+/* ── Stat grid ──────────────────────────────────────────── */
+.stat-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(150px, 1fr));
+  gap: 1rem;
+  margin-bottom: 1.5rem;
+}
+
+/* ── Chart ──────────────────────────────────────────────── */
+.chart-card { margin-bottom: 1.5rem; }
+.chart-card canvas { max-height: 280px; }
+
+/* ── Page header ────────────────────────────────────────── */
+.page-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  margin-bottom: 1.25rem;
+}
+.page-title { font-size: 1.25rem; font-weight: 600; }
+
+/* ── Buttons ────────────────────────────────────────────── */
+.btn {
+  display: inline-flex;
+  align-items: center;
+  gap: .35rem;
+  padding: .4rem .85rem;
+  font-size: .875rem;
+  font-weight: 500;
+  border-radius: .375rem;
+  border: 1px solid transparent;
+  cursor: pointer;
+  text-decoration: none;
+  line-height: 1.5;
+}
+.btn-primary { background: var(--color-primary); color: #fff; border-color: var(--color-primary); }
+.btn-primary:hover { background: var(--color-primary-dk); border-color: var(--color-primary-dk); text-decoration: none; color: #fff; }
+.btn-outline { background: transparent; color: var(--color-primary); border-color: var(--color-primary); }
+.btn-outline:hover { background: var(--color-primary); color: #fff; text-decoration: none; }
+.btn-danger  { background: var(--color-bounced); color: #fff; border-color: var(--color-bounced); }
+.btn-sm { padding: .25rem .6rem; font-size: .8125rem; }
+
+/* ── Forms ──────────────────────────────────────────────── */
+.form-group { margin-bottom: 1rem; }
+.form-label { display: block; font-weight: 500; margin-bottom: .35rem; font-size: .875rem; }
+.form-control {
+  display: block;
+  width: 100%;
+  padding: .4rem .65rem;
+  font-size: .875rem;
+  border: 1px solid var(--color-border);
+  border-radius: .375rem;
+  background: var(--color-surface);
+  color: var(--color-text);
+}
+.form-control:focus { outline: 2px solid var(--color-primary); border-color: transparent; }
+textarea.form-control { min-height: 100px; resize: vertical; }
+
+/* ── Filter bar ──────────────────────────────────────────── */
+.filter-bar {
+  display: flex;
+  flex-wrap: wrap;
+  gap: .5rem;
+  align-items: flex-end;
+  margin-bottom: 1rem;
+  background: var(--color-surface);
+  border: 1px solid var(--color-border);
+  border-radius: .5rem;
+  padding: .75rem 1rem;
+}
+.filter-bar .form-control { width: auto; }
+.filter-bar .form-group { margin-bottom: 0; }
+
+/* ── Tables ──────────────────────────────────────────────── */
+.table-wrapper { overflow-x: auto; background: var(--color-surface); border: 1px solid var(--color-border); border-radius: .5rem; }
+
+table { width: 100%; border-collapse: collapse; font-size: .875rem; }
+th, td { padding: .6rem .85rem; text-align: left; }
+th { font-weight: 600; color: var(--color-text-muted); border-bottom: 1px solid var(--color-border); font-size: .75rem; text-transform: uppercase; letter-spacing: .04em; }
+td { border-bottom: 1px solid var(--color-border); }
+tr:last-child td { border-bottom: none; }
+tr:hover td { background: var(--color-bg); }
+
+/* ── Badges ──────────────────────────────────────────────── */
+.badge {
+  display: inline-block;
+  padding: .2em .55em;
+  font-size: .75rem;
+  font-weight: 600;
+  border-radius: 9999px;
+  text-transform: capitalize;
+}
+.badge-sent       { background: #e9ecef; color: var(--color-sent); }
+.badge-delivered  { background: #d1e7dd; color: #0a3622; }
+.badge-bounced    { background: #f8d7da; color: #58151c; }
+.badge-complained { background: #ffe5d0; color: #6a2d00; }
+.badge-rejected   { background: #f8d7da; color: #58151c; }
+.badge-failed     { background: #e8d5fb; color: #3b0764; }
+.badge-unknown    { background: #e9ecef; color: var(--color-text-muted); }
+
+/* ── Pagination ──────────────────────────────────────────── */
+.pagination { display: flex; align-items: center; gap: .5rem; padding: .75rem 1rem; font-size: .875rem; }
+.pagination-info { color: var(--color-text-muted); }
+.pagination-link { padding: .3rem .65rem; border: 1px solid var(--color-border); border-radius: .375rem; }
+.pagination-link:hover { background: var(--color-bg); text-decoration: none; }
+.pagination-disabled { padding: .3rem .65rem; border: 1px solid var(--color-border); border-radius: .375rem; color: var(--color-text-muted); cursor: default; }
+
+/* ── Webhook URL display ─────────────────────────────────── */
+.webhook-url-wrap { display: flex; align-items: center; gap: .5rem; }
+.webhook-url-input { flex: 1; font-family: monospace; font-size: .8125rem; background: var(--color-bg); }
+
+/* ── Event timeline ──────────────────────────────────────── */
+.event-timeline { list-style: none; }
+.event-item { display: flex; gap: 1rem; padding: .75rem 0; border-bottom: 1px solid var(--color-border); }
+.event-item:last-child { border-bottom: none; }
+.event-time { color: var(--color-text-muted); font-size: .8125rem; white-space: nowrap; min-width: 160px; }
+.event-data-toggle { font-size: .8125rem; cursor: pointer; color: var(--color-primary); border: none; background: none; padding: 0; }
+.event-raw { margin-top: .5rem; background: var(--color-bg); border: 1px solid var(--color-border); border-radius: .375rem; padding: .75rem; font-family: monospace; font-size: .75rem; white-space: pre-wrap; display: none; }
+.event-raw.visible { display: block; }
+
+/* ── Token display ───────────────────────────────────────── */
+.token-display { font-family: monospace; font-size: .8125rem; background: var(--color-bg); padding: .25rem .5rem; border-radius: .25rem; border: 1px solid var(--color-border); }
+
+/* ── Responsive ──────────────────────────────────────────── */
+@media (max-width: 640px) {
+  .stat-grid { grid-template-columns: 1fr 1fr; }
+  .page-header { flex-direction: column; align-items: flex-start; gap: .5rem; }
+  .filter-bar { flex-direction: column; }
+  .filter-bar .form-control { width: 100%; }
+}

data/app/controllers/ses_dashboard/application_controller.rb

@@ -0,0 +1,50 @@
+module SesDashboard
+  class ApplicationController < ActionController::Base
+    protect_from_forgery with: :exception
+
+    before_action :authenticate!
+
+    helper SesDashboard::ApplicationHelper
+
+    rescue_from ActiveRecord::RecordNotFound do
+      respond_to do |format|
+        format.html { render plain: "Not Found", status: :not_found }
+        format.json { render json: { error: "Not Found" }, status: :not_found }
+      end
+    end
+
+    private
+
+    def authenticate!
+      adapter = resolved_adapter
+      return if adapter.nil?  # :none — open access
+
+      unless adapter.authenticate(request)
+        respond_to do |format|
+          format.html do
+            flash[:alert] = "You are not authorized to access this page."
+            redirect_to main_app.root_path
+          end
+          format.json { render json: { error: "Unauthorized" }, status: :unauthorized }
+        end
+      end
+    end
+
+    def resolved_adapter
+      case SesDashboard.configuration.authentication_adapter
+      when :none       then nil
+      when :devise     then Auth::DeviseAdapter.new(nil, controller: self)
+      when :cloudflare then Auth::CloudflareAdapter.new
+      else
+        # Allow a custom adapter object/class to be set directly
+        adapter = SesDashboard.configuration.authentication_adapter
+        adapter.respond_to?(:authenticate) ? adapter : nil
+      end
+    end
+
+    def current_project
+      @current_project ||= Project.find(params[:project_id]) if params[:project_id]
+    end
+    helper_method :current_project
+  end
+end

data/app/controllers/ses_dashboard/dashboard_controller.rb

@@ -0,0 +1,26 @@
+module SesDashboard
+  class DashboardController < ApplicationController
+    def index
+      from = parse_date(params[:from]) || 30.days.ago.beginning_of_day
+      to   = parse_date(params[:to])   || Time.current.end_of_day
+
+      agg = StatsAggregator.new(from: from, to: to)
+
+      @counters     = agg.counters
+      @total_opens  = agg.total_opens
+      @total_clicks = agg.total_clicks
+      @chart_data   = agg.time_series
+      @projects     = Project.ordered
+      @from         = from
+      @to           = to
+    end
+
+    private
+
+    def parse_date(str)
+      Time.zone.parse(str) if str.present?
+    rescue ArgumentError
+      nil
+    end
+  end
+end