shiplog 0.3.1 → 0.4.0

data/app/views/shiplog/newsletter_mailer/announcement.html.erb

@@ -0,0 +1,113 @@
+<%# The newsletter's HTML part: one 600px table column (fluid below that), every style inline (email clients drop
+    stylesheets), absolute image URLs with a width and an alt text, light colours that hold up when a client inverts
+    them for dark mode. @content is a Shiplog::Newsletter::Content: title, month, intro_html / highlights / rest_html
+    when the split rule applies (see Content), else the whole body as html; @unsubscribe_url and @preferences_url are
+    the recipient's own links. Copy this file into your app to change the design; keep the unsubscribe and preferences
+    links and the postal address (the List-Unsubscribe headers are set by the mailer). %>
+<% palette = shiplog_mail_palette %>
+<% font = shiplog_mail_font %>
+<% accent = @content.accent %>
+<% split = @content.highlights_shown? %>
+<!DOCTYPE html>
+<html lang="<%= I18n.locale %>">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="color-scheme" content="light dark">
+<meta name="supported-color-schemes" content="light dark">
+<title><%= @content.title %></title>
+</head>
+<body style="margin:0;padding:0;background-color:<%= palette[:page] %>;color:<%= palette[:text] %>;font-family:<%= font %>;">
+<div style="display:none;max-height:0;overflow:hidden;font-size:1px;line-height:1px;color:<%= palette[:page] %>;"><%= @content.preheader %></div>
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="background-color:<%= palette[:page] %>;">
+<tr>
+<td align="center" style="padding:24px 12px;">
+<table role="presentation" width="600" cellpadding="0" cellspacing="0" border="0" style="width:100%;max-width:600px;">
+<tr>
+<td style="padding:0 4px 14px;font-family:<%= font %>;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td style="font-family:<%= font %>;font-size:16px;font-weight:700;color:<%= palette[:text] %>;vertical-align:middle;">
+<% if @content.logo_url %>
+<%= image_tag @content.logo_url, alt: @content.product_name, width: 140, style: "display:block;width:140px;max-width:140px;height:auto;border:0;" %>
+<% else %>
+<%= @content.product_name %>
+<% end %>
+</td>
+<% if @content.view_url %>
+<td align="right" style="font-family:<%= font %>;font-size:12px;line-height:1.5;color:<%= palette[:muted] %>;vertical-align:middle;white-space:nowrap;">
+<%= link_to t("shiplog.newsletter.mail.view_in_browser"), @content.view_url, style: "color:#{palette[:muted]};text-decoration:underline;" %>
+</td>
+<% end %>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td style="background-color:<%= palette[:card] %>;border:1px solid <%= palette[:border] %>;border-radius:10px;padding:36px 32px 28px;font-family:<%= font %>;">
+<p style="margin:0 0 10px;font-family:<%= font %>;font-size:12px;line-height:1.5;letter-spacing:0.1em;text-transform:uppercase;font-weight:600;color:<%= accent %>;"><%= t("shiplog.categories.announcement", default: "Monthly update") %> · <%= @content.month %></p>
+<h1 style="margin:0 0 16px;font-family:<%= font %>;font-size:32px;line-height:1.2;font-weight:800;letter-spacing:-0.01em;color:<%= palette[:text] %>;"><%= @content.title %></h1>
+<% if split %>
+<%= @content.intro_html %>
+<% else %>
+<%= @content.html %>
+<%= shiplog_mail_button t("shiplog.newsletter.mail.changelog_button"), @content.changelog_url, accent %>
+<% end %>
+</td>
+</tr>
+<% if split %>
+<% @content.highlights.each do |highlight| %>
+<tr>
+<td style="padding:16px 0 0;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="background-color:<%= palette[:card] %>;border:1px solid <%= palette[:border] %>;border-radius:10px;">
+<% if highlight.image? %>
+<tr>
+<td style="padding:0;line-height:0;">
+<%= shiplog_mail_screenshot(highlight) %>
+</td>
+</tr>
+<% end %>
+<tr>
+<td style="padding:24px 28px 26px;font-family:<%= font %>;">
+<h2 style="margin:0 0 8px;font-family:<%= font %>;font-size:21px;line-height:1.3;font-weight:700;color:<%= palette[:text] %>;"><%= link_to highlight.title, highlight.url, style: "color:#{palette[:text]};text-decoration:none;" %></h2>
+<% if highlight.summary.present? %>
+<p style="margin:0;font-family:<%= font %>;font-size:16px;line-height:1.6;color:<%= palette[:muted] %>;"><%= highlight.summary %></p>
+<% end %>
+<%= shiplog_mail_button t("shiplog.newsletter.mail.highlight_button"), highlight.url, accent, margin: "18px 0 0" %>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<% end %>
+<tr>
+<td style="padding:16px 0 0;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="background-color:<%= palette[:card] %>;border:1px solid <%= palette[:border] %>;border-radius:10px;">
+<tr>
+<td style="padding:28px 32px 28px;font-family:<%= font %>;">
+<%= @content.rest_html %>
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="margin:24px 0 0;"><tr><td style="border-top:1px solid <%= palette[:border] %>;font-size:0;line-height:0;">&nbsp;</td></tr></table>
+<%= shiplog_mail_button t("shiplog.newsletter.mail.changelog_button"), @content.changelog_url, accent, margin: "20px 0 0" %>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<% end %>
+<tr>
+<td style="padding:28px 12px 8px;font-family:<%= font %>;font-size:12px;line-height:1.7;color:<%= palette[:muted] %>;text-align:center;">
+<%= t("shiplog.newsletter.mail.reason", product: @content.product_name) %><br>
+<%= link_to t("shiplog.newsletter.mail.unsubscribe"), @unsubscribe_url, style: "color:#{palette[:muted]};text-decoration:underline;" %>
+·
+<%= link_to t("shiplog.newsletter.mail.preferences"), @preferences_url, style: "color:#{palette[:muted]};text-decoration:underline;" %>
+<% if @content.address.present? %>
+<br><%= @content.address %>
+<% end %>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+</body>
+</html>

data/app/views/shiplog/newsletter_mailer/announcement.text.erb

@@ -0,0 +1,38 @@
+<%# The newsletter's text part: title, month, the intro, the highlights ("Title — sentence", then the URL) and the rest
+    of the body when the split rule applies (see Shiplog::Newsletter::Content), else the whole body; then the links. %>
+<%= @content.title %>
+<%= t("shiplog.categories.announcement", default: "Monthly update") %> · <%= @content.month %>
+<% if @content.view_url %>
+
+<%= t("shiplog.newsletter.mail.view_in_browser") %>: <%= @content.view_url %>
+<% end %>
+<% if @content.highlights_shown? %>
+<% if @content.intro_text.present? %>
+
+<%= @content.intro_text %>
+<% end %>
+<% @content.highlights.each do |highlight| %>
+
+<%= highlight.title %><% if highlight.summary.present? %> — <%= highlight.summary %><% end %>
+<%= highlight.url %>
+<% end %>
+<% if @content.rest_text.present? %>
+
+<%= @content.rest_text %>
+<% end %>
+<% else %>
+
+<%= @content.text %>
+<% end %>
+<% if @content.changelog_url %>
+
+<%= t("shiplog.newsletter.mail.changelog_button") %>: <%= @content.changelog_url %>
+<% end %>
+
+--
+<%= t("shiplog.newsletter.mail.reason", product: @content.product_name) %>
+<%= t("shiplog.newsletter.mail.unsubscribe") %>: <%= @unsubscribe_url %>
+<%= t("shiplog.newsletter.mail.preferences") %>: <%= @preferences_url %>
+<% if @content.address.present? %>
+<%= @content.address %>
+<% end %>

data/app/views/shiplog/newsletter_mailer/confirmation.html.erb

@@ -0,0 +1,43 @@
+<%# The double opt-in email: a button (and the link as text) the visitor opens to confirm; @subscriber, @confirmation_url
+    and @product_name. The link works for 7 days; a page with a button is what it opens (a POST confirms), so a
+    link scanner that prefetches it confirms nothing. %>
+<% palette = shiplog_mail_palette %>
+<% font = shiplog_mail_font %>
+<% accent = Shiplog.config.newsletter_accent || "#0969da" %>
+<!DOCTYPE html>
+<html lang="<%= I18n.locale %>">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="color-scheme" content="light dark">
+<meta name="supported-color-schemes" content="light dark">
+<title><%= t("shiplog.newsletter.mail.confirm_subject", product: @product_name) %></title>
+</head>
+<body style="margin:0;padding:0;background-color:<%= palette[:page] %>;color:<%= palette[:text] %>;font-family:<%= font %>;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="background-color:<%= palette[:page] %>;">
+<tr>
+<td align="center" style="padding:24px 12px;">
+<table role="presentation" width="600" cellpadding="0" cellspacing="0" border="0" style="width:100%;max-width:600px;">
+<tr>
+<td style="background-color:<%= palette[:card] %>;border-radius:8px;padding:32px;font-family:<%= font %>;">
+<% if Shiplog.config.newsletter_logo_url %>
+<%= image_tag Shiplog.config.newsletter_logo_url, alt: @product_name, width: 140, style: "display:block;width:140px;max-width:140px;height:auto;border:0;margin:0 0 24px;" %>
+<% end %>
+<h1 style="margin:0 0 16px;font-family:<%= font %>;font-size:22px;line-height:1.3;font-weight:700;color:<%= palette[:text] %>;"><%= t("shiplog.newsletter.mail.confirm_heading") %></h1>
+<p style="margin:0 0 12px;font-family:<%= font %>;font-size:16px;line-height:1.6;color:<%= palette[:text] %>;"><%= t("shiplog.newsletter.mail.confirm_intro", product: @product_name, email: @subscriber.email) %></p>
+<%= shiplog_mail_button t("shiplog.newsletter.mail.confirm_button"), @confirmation_url, accent %>
+<p style="margin:24px 0 0;font-family:<%= font %>;font-size:13px;line-height:1.6;color:<%= palette[:muted] %>;"><%= t("shiplog.newsletter.mail.confirm_expiry") %></p>
+<p style="margin:12px 0 0;font-family:<%= font %>;font-size:12px;line-height:1.6;color:<%= palette[:muted] %>;word-break:break-all;"><%= t("shiplog.newsletter.mail.confirm_link_text") %> <%= link_to @confirmation_url, @confirmation_url, style: "color:#{palette[:muted]};" %></p>
+</td>
+</tr>
+<% if Shiplog.config.newsletter_address.present? %>
+<tr>
+<td style="padding:24px 12px;font-family:<%= font %>;font-size:12px;line-height:1.7;color:<%= palette[:muted] %>;text-align:center;"><%= Shiplog.config.newsletter_address %></td>
+</tr>
+<% end %>
+</table>
+</td>
+</tr>
+</table>
+</body>
+</html>

data/app/views/shiplog/newsletter_mailer/confirmation.text.erb

@@ -0,0 +1,12 @@
+<%# The double opt-in email's text part. %>
+<%= t("shiplog.newsletter.mail.confirm_heading") %>
+
+<%= t("shiplog.newsletter.mail.confirm_intro", product: @product_name, email: @subscriber.email) %>
+
+<%= t("shiplog.newsletter.mail.confirm_button") %>: <%= @confirmation_url %>
+
+<%= t("shiplog.newsletter.mail.confirm_expiry") %>
+<% if Shiplog.config.newsletter_address.present? %>
+
+<%= Shiplog.config.newsletter_address %>
+<% end %>

data/config/admin_routes.rb

@@ -5,6 +5,15 @@ Shiplog::Admin::Engine.routes.draw do
       resource :approval, only: :create
       resource :discard, only: %i[create destroy]
       resource :rewrite, only: :create
+      # An announcement's text as a file to paste elsewhere: ?as=markdown, html or text, in the default locale or
+      # ?export_locale= (not :locale, which a host's locale-switching around_action would read; see translations).
+      get "export", to: "exports#show", as: :export
+      resource :announcement_notification, only: :create
+      # The newsletter of an announcement: the confirmation step with the recipient counts (show), the send
+      # (create), a test to the admin's address, and the retry of failed deliveries.
+      resource :newsletter, only: %i[show create]
+      resource :newsletter_test, only: :create, path: "newsletter/test"
+      resource :newsletter_retry, only: :create, path: "newsletter/retry"
       # The locale segment is :translation_locale, not :locale: a host's around_action that switches the locale
       # from params[:locale] must not read it (a configured translation locale may not be an available one).
       locale = { translation_locale: /[A-Za-z][A-Za-z0-9_-]*/ }
@@ -15,6 +24,9 @@ Shiplog::Admin::Engine.routes.draw do
       end
     end
   end
+  resources :announcements, only: :create
+  # The newsletter's subscribers: counts, a searchable list (?q=), removal, and the CSV export (.csv).
+  resources :newsletter_subscribers, only: %i[index destroy], path: "newsletter"
   resource :area_detection, only: :create, path: "areas/detection"
   resource :area_translation, only: :create, path: "areas/translation"
   resources :areas, only: %i[index update destroy] do

data/config/locales/en.yml

@@ -14,6 +14,7 @@ en:
     categories:
       feature: New
       change: Improved
+      announcement: Monthly update
     empty: Nothing here yet
     date_format: "%-d %B %Y"
     roadmap:
@@ -55,17 +56,161 @@ en:
       nav_label: More changelog entries
       newer: "← Newer: %{title}"
       older: "Older: %{title} →"
+    announcements:
+      read: "Read the %{month} summary"
+      back: "← Back to the changelog"
+      skeleton:
+        features: New
+        also_improved: Also improved
     feed:
       title_with_product: "%{product} changelog"
       link_title: Changelog (Atom)
       subscribe: Subscribe (Atom)
+    newsletter:
+      title: Newsletter
+      product: Product updates
+      back: "← Back to the changelog"
+      form:
+        title: Get the monthly summary by email
+        hint: One email a month, no more. Unsubscribe any time.
+        email_label: Email address
+        email_placeholder: you@example.com
+        submit: Subscribe
+        trap_label: Leave this field empty
+        invalid_email: Enter a valid email address.
+      sent:
+        heading: Check your inbox
+        text: We sent you a link to confirm your subscription. Open it to start receiving the monthly summary. If nothing arrives within a few minutes, look in your spam folder.
+      confirm:
+        heading: Confirm your subscription
+        text: "Click the button to receive the monthly summary at %{email}."
+        button: Confirm
+        done_heading: You're subscribed
+        done_text: "The monthly summary will arrive at %{email}. You can change the language or unsubscribe any time from your preferences."
+      preferences:
+        heading: Your subscription
+        email: Email
+        status: Status
+        statuses:
+          pending: Waiting for confirmation
+          confirmed: Subscribed
+          unsubscribed: Unsubscribed
+        language: Language
+        save: Save
+        saved: Preferences saved.
+        unsubscribe: Unsubscribe
+        unsubscribed: You're unsubscribed.
+        resubscribe: Resubscribe
+        resubscribed: You're subscribed again.
+        delete: Delete my data
+        delete_help: Deleting your data removes your address from our records entirely, including the record that you unsubscribed.
+        deleted_heading: Your data was deleted
+        deleted_text: Your email address is no longer stored. You can subscribe again from the changelog at any time.
+      unsubscribe:
+        heading: Unsubscribe
+        text: "Stop receiving the monthly summary at %{email}?"
+        button: Unsubscribe
+        done_heading: You're unsubscribed
+        done_text: "%{email} will not receive the monthly summary anymore."
+      invalid:
+        heading: This link is not valid
+        text: It may have expired or already been used. Subscribe again from the changelog to get a new one.
+      rate_limited:
+        heading: Too many attempts
+        text: Please try again in an hour.
+      mail:
+        view_in_browser: View in browser
+        changelog_button: See everything that shipped
+        highlight_button: See how it works
+        reason: "You receive this email because you subscribed to the %{product} monthly summary."
+        unsubscribe: Unsubscribe
+        preferences: Preferences
+        confirm_subject: "Confirm your subscription to the %{product} newsletter"
+        confirm_heading: One more step
+        confirm_intro: "Confirm that you want to receive the %{product} monthly summary at %{email}."
+        confirm_button: Confirm my subscription
+        confirm_expiry: "The link works for 7 days. If you did not ask for this, ignore this email: nothing is sent without confirmation."
+        confirm_link_text: "Or copy this link:"
     admin:
+      newsletter:
+        title: Newsletter
+        help: The visitors who subscribed through the changelog's form. Your own users (config.newsletter_recipients) are not listed here.
+        total: Total
+        search: Search
+        search_placeholder: Search by email
+        clear: Clear
+        export: Download CSV
+        remove: Remove
+        removed: "%{email} removed."
+        empty: No subscribers yet.
+        no_match: "No subscriber matches “%{query}”."
+        statuses:
+          pending: Pending
+          confirmed: Confirmed
+          unsubscribed: Unsubscribed
+        columns:
+          email: Email
+          locale: Language
+          status: Status
+          source: Signed up on
+          subscribed_at: Signed up
+          recipients: Recipients
+        heading: Newsletter
+        not_sent: Not sent yet.
+        progress: "%{sent} sent, %{failed} failed, %{pending} pending."
+        stalled:
+          one: "%{count} has been pending for more than an hour (the worker may have died): Retry sends it again."
+          other: "%{count} have been pending for more than an hour (the worker may have died): Retry sends them again."
+        retry: Retry failed
+        retry_queued: Retrying the failed deliveries.
+        send: Send…
+        send_blocked: "Sending is not possible yet: %{reasons}."
+        blockers:
+          not_approved: the announcement is not approved
+          translations: "a translation is missing or stale (%{locales})"
+          from: config.newsletter_from is not set
+          address: config.newsletter_address is not set
+          base_url: config.canonical_url is not set (the links in emails must be absolute)
+        test: "Send a test to %{email}"
+        test_locale: Language
+        test_sent: "Test sent to %{email} (%{language})."
+        test_failed: "The test could not be sent (%{error}). See the log."
+        test_no_email: config.current_admin gives no email address, so no test can be sent.
+        confirm_title: "Send the newsletter: %{title}"
+        recipients: Recipients
+        recipients_none: Nobody to send to yet.
+        recipients_error: "The recipients could not be listed (%{error}). See the log for details."
+        confirm_help: Each recipient receives the email once, in their language. Sending again later only reaches the recipients who have not received it.
+        confirm_resend_help: Recipients who already received it are skipped.
+        confirm_button:
+          one: "Send to %{count} recipient"
+          other: "Send to %{count} recipients"
+        queued: The newsletter is being sent. Refresh in a moment.
+        back: Back to the announcement
+      announcements:
+        draft: "Draft announcement for %{month}"
+        drafted: Announcement draft ready.
+        nothing_to_announce: That month has no approved feature or change to announce yet.
+        publishing: Announcement
+        view_page: View the public page
+        external: Published by your app (config.announcements = :external).
+        announced: "Your app was notified (on_announcement_approved) at %{time}."
+        waiting_for_translations: Your app will be notified once every translation is current.
+        announcing: Notifying your app…
+        not_approved: Approve it to publish it and notify your app.
+        export: "Export:"
+        plain_text: Plain text
+        preview: Preview
+        notify_now: Notify now
+        notify_now_hint: Calls your app's hook now, without waiting for missing translations (English is used for them).
+        notify_queued: Your app will be notified in a moment.
       title: Shiplog admin
       nav:
         drafts: Drafts
         board: Roadmap board
         sync: Sync
         areas: Areas
+        newsletter: Newsletter
       areas:
         title: Product areas
         help: The AI groups entries into areas (at most %{max}) while it rewrites them. Visitors can filter the changelog by area once two areas have published entries.
@@ -126,6 +271,7 @@ en:
         area_gone: no longer exists
         regenerate_warning: Regenerating unpublishes this entry until re-approved.
         source_changed: GitHub text changed since this draft
+        entries_changed: The month's entries changed since this draft
         rewrite_error: Rewrite failed
         not_rewritten: Not rewritten yet
         public_text: Public text
@@ -175,6 +321,7 @@ en:
           roadmap: Roadmap
           feature: Feature
           change: Change
+          announcement: Announcement
         columns:
           entry: Entry
           kind: Kind

data/config/locales/es.yml

@@ -18,6 +18,7 @@ es:
     categories:
       feature: Nuevo
       change: Mejorado
+      announcement: Resumen mensual
     empty: Todavía no hay nada
     date_format: "%-d de %B de %Y"
     roadmap:
@@ -59,17 +60,161 @@ es:
       nav_label: Más cambios
       newer: "← Más reciente: %{title}"
       older: "Anterior: %{title} →"
+    announcements:
+      read: "Leer el resumen de %{month}"
+      back: "← Volver al registro de cambios"
+      skeleton:
+        features: Novedades
+        also_improved: También mejoramos
     feed:
       title_with_product: "Registro de cambios de %{product}"
       link_title: Registro de cambios (Atom)
       subscribe: Suscribirse (Atom)
+    newsletter:
+      title: Boletín
+      product: Novedades del producto
+      back: "← Volver al registro de cambios"
+      form:
+        title: Recibe el resumen mensual por correo
+        hint: Un correo al mes, nada más. Date de baja cuando quieras.
+        email_label: Dirección de correo
+        email_placeholder: tu@ejemplo.com
+        submit: Suscribirme
+        trap_label: Deja este campo vacío
+        invalid_email: Escribe una dirección de correo válida.
+      sent:
+        heading: Revisa tu bandeja de entrada
+        text: Te hemos enviado un enlace para confirmar la suscripción. Ábrelo para empezar a recibir el resumen mensual. Si no llega en unos minutos, mira en la carpeta de spam.
+      confirm:
+        heading: Confirma tu suscripción
+        text: "Pulsa el botón para recibir el resumen mensual en %{email}."
+        button: Confirmar
+        done_heading: Suscripción confirmada
+        done_text: "El resumen mensual llegará a %{email}. Puedes cambiar el idioma o darte de baja cuando quieras desde tus preferencias."
+      preferences:
+        heading: Tu suscripción
+        email: Correo
+        status: Estado
+        statuses:
+          pending: Pendiente de confirmación
+          confirmed: Suscrito
+          unsubscribed: Dado de baja
+        language: Idioma
+        save: Guardar
+        saved: Preferencias guardadas.
+        unsubscribe: Darme de baja
+        unsubscribed: Te has dado de baja.
+        resubscribe: Volver a suscribirme
+        resubscribed: Vuelves a estar suscrito.
+        delete: Borrar mis datos
+        delete_help: Borrar tus datos elimina tu dirección de nuestros registros por completo, incluido el registro de tu baja.
+        deleted_heading: Tus datos se han borrado
+        deleted_text: Tu dirección de correo ya no está guardada. Puedes volver a suscribirte desde el registro de cambios cuando quieras.
+      unsubscribe:
+        heading: Darse de baja
+        text: "¿Dejar de recibir el resumen mensual en %{email}?"
+        button: Darme de baja
+        done_heading: Te has dado de baja
+        done_text: "%{email} ya no recibirá el resumen mensual."
+      invalid:
+        heading: Este enlace no es válido
+        text: Puede que haya caducado o que ya se haya usado. Vuelve a suscribirte desde el registro de cambios para recibir otro.
+      rate_limited:
+        heading: Demasiados intentos
+        text: Inténtalo de nuevo dentro de una hora.
+      mail:
+        view_in_browser: Ver en el navegador
+        changelog_button: Ver todo lo que hemos lanzado
+        highlight_button: Ver cómo funciona
+        reason: "Recibes este correo porque te suscribiste al resumen mensual de %{product}."
+        unsubscribe: Darme de baja
+        preferences: Preferencias
+        confirm_subject: "Confirma tu suscripción al boletín de %{product}"
+        confirm_heading: Un paso más
+        confirm_intro: "Confirma que quieres recibir el resumen mensual de %{product} en %{email}."
+        confirm_button: Confirmar mi suscripción
+        confirm_expiry: "El enlace funciona durante 7 días. Si no has pedido esto, ignora este correo: no se envía nada sin confirmación."
+        confirm_link_text: "O copia este enlace:"
     admin:
+      newsletter:
+        title: Boletín
+        help: Los visitantes que se suscribieron desde el formulario del registro de cambios. Tus propios usuarios (config.newsletter_recipients) no aparecen aquí.
+        total: Total
+        search: Buscar
+        search_placeholder: Buscar por correo
+        clear: Limpiar
+        export: Descargar CSV
+        remove: Eliminar
+        removed: "%{email} eliminado."
+        empty: Todavía no hay suscriptores.
+        no_match: "Ningún suscriptor coincide con “%{query}”."
+        statuses:
+          pending: Pendiente
+          confirmed: Confirmado
+          unsubscribed: Dado de baja
+        columns:
+          email: Correo
+          locale: Idioma
+          status: Estado
+          source: Página de alta
+          subscribed_at: Alta
+          recipients: Destinatarios
+        heading: Boletín
+        not_sent: Todavía no se ha enviado.
+        progress: "%{sent} enviados, %{failed} fallidos, %{pending} pendientes."
+        stalled:
+          one: "%{count} lleva más de una hora pendiente (puede que el worker se haya caído): Reintentar lo envía de nuevo."
+          other: "%{count} llevan más de una hora pendientes (puede que el worker se haya caído): Reintentar los envía de nuevo."
+        retry: Reintentar los fallidos
+        retry_queued: Reintentando los envíos fallidos.
+        send: Enviar…
+        send_blocked: "Todavía no se puede enviar: %{reasons}."
+        blockers:
+          not_approved: el anuncio no está aprobado
+          translations: "falta una traducción o está desactualizada (%{locales})"
+          from: config.newsletter_from no está configurado
+          address: config.newsletter_address no está configurado
+          base_url: config.canonical_url no está configurado (los enlaces de los correos deben ser absolutos)
+        test: "Enviar una prueba a %{email}"
+        test_locale: Idioma
+        test_sent: "Prueba enviada a %{email} (%{language})."
+        test_failed: "No se pudo enviar la prueba (%{error}). Consulta el registro."
+        test_no_email: config.current_admin no devuelve una dirección de correo, así que no se puede enviar ninguna prueba.
+        confirm_title: "Enviar el boletín: %{title}"
+        recipients: Destinatarios
+        recipients_none: Todavía no hay nadie a quien enviarlo.
+        recipients_error: "No se pudo obtener la lista de destinatarios (%{error}). Consulta el registro para más detalles."
+        confirm_help: Cada destinatario recibe el correo una sola vez, en su idioma. Si lo envías de nuevo más tarde, solo llega a quienes no lo han recibido.
+        confirm_resend_help: Se omite a quienes ya lo recibieron.
+        confirm_button:
+          one: "Enviar a %{count} destinatario"
+          other: "Enviar a %{count} destinatarios"
+        queued: El boletín se está enviando. Actualiza la página en un momento.
+        back: Volver al anuncio
+      announcements:
+        draft: "Redactar el anuncio de %{month}"
+        drafted: El borrador del anuncio está listo.
+        nothing_to_announce: Ese mes aún no tiene ninguna función o cambio aprobado que anunciar.
+        publishing: Anuncio
+        view_page: Ver la página pública
+        external: Lo publica tu aplicación (config.announcements = :external).
+        announced: "Se avisó a tu aplicación (on_announcement_approved) el %{time}."
+        waiting_for_translations: Se avisará a tu aplicación cuando todas las traducciones estén al día.
+        announcing: Avisando a tu aplicación…
+        not_approved: Apruébalo para publicarlo y avisar a tu aplicación.
+        export: "Exportar:"
+        plain_text: Texto sin formato
+        preview: Vista previa
+        notify_now: Avisar ahora
+        notify_now_hint: Llama ahora al hook de tu aplicación, sin esperar las traducciones que falten (se usa el inglés).
+        notify_queued: Se avisará a tu aplicación en un momento.
       title: Administración de Shiplog
       nav:
         drafts: Borradores
         board: Tablero de la hoja de ruta
         sync: Sincronización
         areas: Áreas
+        newsletter: Boletín
       areas:
         title: Áreas del producto
         help: La IA agrupa las entradas en áreas (como máximo %{max}) mientras las reescribe. Los visitantes pueden filtrar el registro de cambios por área cuando hay dos áreas con entradas publicadas.
@@ -130,6 +275,7 @@ es:
         area_gone: ya no existe
         regenerate_warning: Al regenerar, esta entrada deja de estar publicada hasta que se apruebe de nuevo.
         source_changed: El texto de GitHub cambió desde este borrador
+        entries_changed: Las entradas del mes cambiaron desde este borrador
         rewrite_error: Falló la reescritura
         not_rewritten: Todavía sin reescribir
         public_text: Texto público
@@ -179,6 +325,7 @@ es:
           roadmap: Hoja de ruta
           feature: Función
           change: Cambio
+          announcement: Anuncio
         columns:
           entry: Entrada
           kind: Tipo

data/config/routes.rb

@@ -7,5 +7,18 @@ Shiplog::Engine.routes.draw do
     format: false, constraints: { slug: /[a-z0-9-]+/ }
   get Shiplog.config.changelog_path, to: "changelogs#show", as: :changelog
   post "shiplog/github/webhook", to: "webhooks#create", as: :github_webhook
+  # The newsletter's pages live under shiplog/ (like the webhook), so a host that constrains the engine's mount to
+  # the changelog, the roadmap and /shiplog/ lets them through. Links from emails open a page with a button
+  # (GET), and the button POSTs: nothing changes state on a GET. A token is URL-safe base64 or base58.
+  token = { token: /[A-Za-z0-9_-]+/ }
+  get "shiplog/newsletter/subscription", to: "newsletter/subscriptions#show", as: :newsletter_subscription
+  post "shiplog/newsletter/subscription", to: "newsletter/subscriptions#create"
+  get "shiplog/newsletter/confirm/:token", to: "newsletter/confirmations#show", as: :newsletter_confirmation, constraints: token, format: false
+  post "shiplog/newsletter/confirm/:token", to: "newsletter/confirmations#create", constraints: token, format: false
+  get "shiplog/newsletter/preferences/:token", to: "newsletter/preferences#show", as: :newsletter_preferences, constraints: token, format: false
+  patch "shiplog/newsletter/preferences/:token", to: "newsletter/preferences#update", constraints: token, format: false
+  delete "shiplog/newsletter/preferences/:token", to: "newsletter/preferences#destroy", constraints: token, format: false
+  get "shiplog/newsletter/unsubscribe/:token", to: "newsletter/unsubscriptions#show", as: :newsletter_unsubscription, constraints: token, format: false
+  post "shiplog/newsletter/unsubscribe/:token", to: "newsletter/unsubscriptions#create", constraints: token, format: false
   get "shiplog/assets/:version/:name", to: "frontends#show", as: :frontend, constraints: { version: /[^\/]+/, name: /[a-z_]+\.(css|js)/ }
 end

data/db/migrate/20261028000001_shiplog_0_4_0.rb

@@ -0,0 +1,19 @@
+# Everything 0.4.0 adds to the schema, one section per feature. Additive and reversible.
+class Shiplog040 < ActiveRecord::Migration[8.1]
+  def change
+    # --- Monthly announcements ---
+    # The subject of an announcement entry: one row per month (starts_on is its first day, ends_on its last), so
+    # Shiplog::Entry keeps its polymorphic subject and its unique (subject, kind) index makes drafting idempotent.
+    create_table :shiplog_periods do |t|
+      t.date :starts_on, null: false
+      t.date :ends_on, null: false
+      t.timestamps
+    end
+    add_index :shiplog_periods, :starts_on, unique: true
+
+    # When config.on_announcement_approved was called for the announcement's current approval: set once it is
+    # approved and every configured locale has a current translation, cleared when it returns to draft, so the
+    # hook runs once per approval.
+    add_column :shiplog_entries, :announced_at, :datetime
+  end
+end