docs(swap): EQD-5320 EmailTemplateService补设计守卫注释——占位符朴素替换/不做HTML转义均为有意决策，与bond-oms Java SwapEmailHandler同构，勿单边升级模板引擎或加转义，新占位符两侧同步

2026-08-21 09:24:23 +08:00
parent 433bca9530
commit 00ae047e01
1 changed files with 6 additions and 1 deletions
@@ -74,7 +74,12 @@ namespace YLErp.Modules.AppModule
        }

        /// <summary>
-        /// 生成邮件信息，如果template为null，返回null
+        /// 生成邮件信息，如果template为null，返回null。
+        /// 【设计决策·勿单边"升级"】占位符为朴素文本替换（非模板引擎），与本表另一消费者
+        /// bond-oms Java SwapEmailHandler.replaceMailPlaceholders 保持同构渲染语义——
+        /// 单边引入 FreeMarker/Thymeleaf 等更强语法或 HTML 转义，会造成两侧发出内容不一致。
+        /// 替换值(客户名称/文档编号等)不做 HTML 转义是有意为之：均为内部维护的可信数据；
+        /// 若未来要拼接用户自由输入的内容，必须两侧同步加转义。新占位符同样两侧同步加白名单。
        /// </summary>
        public static MailInfoResultModel GenerateMailInfo(EmailTemplate template, MailInfoRequestModel reqModel)
        {