feat: email template management with DB override, modern mail redesign

2026-04-29 07:27:26 +08:00 · 2026-04-18 15:40:20 +08:00
parent e689699f44
commit 9ba946621e
14 changed files with 616 additions and 223 deletions
@@ -0,0 +1,78 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+class MailTemplate extends Model
+{
+    protected $table = 'v2_mail_templates';
+
+    protected $fillable = ['name', 'subject', 'content'];
+
+    /**
+     * Template definitions: required/optional vars and default content.
+     */
+    public const TEMPLATES = [
+        'verify' => [
+            'label' => '邮箱验证码',
+            'required_vars' => ['code'],
+            'optional_vars' => ['name', 'url'],
+        ],
+        'notify' => [
+            'label' => '站点通知',
+            'required_vars' => ['content'],
+            'optional_vars' => ['name', 'url'],
+        ],
+        'remindExpire' => [
+            'label' => '到期提醒',
+            'required_vars' => [],
+            'optional_vars' => ['name', 'url'],
+        ],
+        'remindTraffic' => [
+            'label' => '流量提醒',
+            'required_vars' => [],
+            'optional_vars' => ['name', 'url'],
+        ],
+        'mailLogin' => [
+            'label' => '邮件登录',
+            'required_vars' => ['link'],
+            'optional_vars' => ['name', 'url'],
+        ],
+    ];
+
+    /**
+     * Get template metadata (vars, label) for a given template name.
+     */
+    public static function getMeta(string $name): ?array
+    {
+        return self::TEMPLATES[$name] ?? null;
+    }
+
+    /**
+     * Get all template names.
+     */
+    public static function getNames(): array
+    {
+        return array_keys(self::TEMPLATES);
+    }
+
+    /**
+     * Validate that required placeholders are present in the content.
+     */
+    public static function validateContent(string $name, string $content): array
+    {
+        $meta = self::getMeta($name);
+        if (!$meta) {
+            return ["Unknown template: {$name}"];
+        }
+
+        $errors = [];
+        foreach ($meta['required_vars'] as $var) {
+            if (strpos($content, '{{' . $var . '}}') === false) {
+                $errors[] = "缺少必要占位符: {{{$var}}}";
+            }
+        }
+        return $errors;
+    }
+}