1.9 KiB
1.9 KiB
6.14 文件模板管理
:::tip 概述 文件模板模块（goframe_file_template，平台级表）在线管理文件/代码片段模板：code 全局唯一、按编码查询（getTemplateByCode）。注意与代码生成器的磁盘模板（templates/*.tpl）是两套互不相干的体系。 :::
接口清单
七件套：sys:fileTemplate:{page|list|detail|add|update|delete|batchDelete}
GET /api/file/template/getTemplateByCode/:code 登录即可 按编码查模板
模块特征
| 特征 | 实现 |
|---|---|
| 唯一性 | code 全局唯一（uk_code）；Add 走 CheckUnique 预检 |
| 平台级 | 无租户隔离（全局模板库） |
| 快捷查询 | getTemplateByCode（登录即可，供业务按编码取模板内容） |
| 内容形态 | 模板正文（文本/HTML/代码片段） |
易混淆点：两套"模板"
::: warning 两套模板互不相干
| templates/*.tpl（磁盘目录） | goframe_file_template 表 | |
|---|---|---|
| 定位 | 代码生成器的渲染模板 | 业务功能（在线管理文件/代码片段模板） |
| 消费方 | generator.go 直接读取渲染 | /api/file/template 模块 + getTemplateByCode |
| 版本管理 | 随仓库版本管理 | 数据库数据 |
| 修改影响 | 改变生成产物风格 | 影响业务取到的模板内容 |
修改生成产物改 templates/*.tpl；不要到 file_template 表里找生成器模板。两者无调用关系。
:::
使用场景
* 系统内需要下发"格式文本"的场景：导出模板、打印模板、消息模板、代码片段
* 业务按编码取模板：GET /api/file/template/getTemplateByCode/{code}
* 在线编辑维护：模板管理页 CRUD（无需发版）
管理建议
- code 命名语义化（如 export_header / print_invoice），全局唯一
- 模板内容变更即时生效（无缓存层，按编码实时查询）
- 平台级模块——租户差异化模板需扩展（或按 code 前缀约定租户命名空间）