feat(postcard): database overrides for mail templates with file fallback

- postcard owns the system_mail_* tables (postcard.Migrations), run by lagoon
  as the framework set summercms.postcard after system_files
- Send asks an OverrideSource once per message; NewDBSource reads the
  customized template row through the *gorm.DB published on the app
- a failed lookup, missing tables or an override that does not render or
  fails the safety checks sends the file version and is logged
- the caller's Message.Subject still wins; Mailer, Message, NewMailer,
  Catalog.Register and BootPlugin keep their signatures

Plan 35-01, task 2 (tracer).
This commit is contained in:
Jakub Zych
2026-11-13 10:26:10 +01:00
parent 3198bbe1aa
commit 7e5d2c74af
10 changed files with 932 additions and 30 deletions

View File

@@ -9,6 +9,7 @@ import (
"git.golem15.com/golem15/summercms/modules/lagoon/attach"
"git.golem15.com/golem15/summercms/modules/pact"
"git.golem15.com/golem15/summercms/modules/party"
"git.golem15.com/golem15/summercms/modules/postcard"
"github.com/go-gormigrate/gormigrate/v2"
"gorm.io/gorm"
)
@@ -208,15 +209,15 @@ type MigrationRef struct {
// migrationSet is one history table's declared migrations.
type migrationSet struct {
id string
// label names the set in Migrate's errors: "system_files", "backend
// admin", "deferred bindings", "queue" or the plugin ID.
// label names the set in Migrate's errors: "system_files", "mail",
// "backend admin", "deferred bindings", "queue" or the plugin ID.
label string
migrations []*gormigrate.Migration
}
// migrationSets lists the sets Migrate applies, in its order: the framework
// sets (system files, backend admin, deferred bindings, job queue), then each
// plugin's HasMigrations set in plugin order.
// sets (system files, mail, backend admin, deferred bindings, job queue),
// then each plugin's HasMigrations set in plugin order.
func migrationSets(gdb *gorm.DB, plugins []party.Plugin) ([]migrationSet, error) {
sqlDB, err := gdb.DB()
if err != nil {
@@ -224,6 +225,7 @@ func migrationSets(gdb *gorm.DB, plugins []party.Plugin) ([]migrationSet, error)
}
sets := []migrationSet{
{"summercms.attach", "system_files", attach.Migrations},
{"summercms.postcard", "mail", postcard.Migrations},
{"summercms.cabana", "backend admin", BackendAdminMigrations},
{DeferredHistoryID, "deferred bindings", DeferredBindingMigrations},
{QueueHistoryID, "queue", QueueMigrations(sqlDB)},