djangoadmin-wiki/DjangoAdmin_Tornado_EleVue/zh/volume4/business/file-template.md

文件模板管理

:::tip 说明 文件模板管理模块提供文件导入导出模板的管理能力，用于维护各种业务场景的 Excel/Word 等模板文件。模块位于 src/modules/file_template/。 :::

模块结构

src/modules/file_template/
├── models.py         # 模板模型
├── schemas.py        # 参数验证
├── repository.py     # 数据访问层
├── service.py        # 业务逻辑层
└── handlers.py       # 请求处理器

数据模型

class FileTemplate(BaseModel):
    """文件模板模型"""
    __tablename__ = "file_template"

    name = Column(String(255), nullable=False, comment="模板名称")
    code = Column(String(100), default="", comment="模板编码")
    file_url = Column(String(500), default="", comment="模板文件路径")
    remark = Column(String(500), default="", comment="备注")
    status = Column(Integer, default=0, comment="状态")
    sort = Column(Integer, default=0, comment="排序")

API 接口

接口	方法	权限	说明
/api/v1/filetemplate/page	GET	sys:filetemplate:list	分页查询
/api/v1/filetemplate/detail/(\d+)	GET	sys:filetemplate:detail	详情查询
/api/v1/filetemplate/add	POST	sys:filetemplate:add	新增
/api/v1/filetemplate/update	PUT	sys:filetemplate:update	更新
/api/v1/filetemplate/delete/(\d+)	DELETE	sys:filetemplate:delete	删除

使用场景

• 数据导入模板：用户管理、商品管理等模块的 Excel 导入模板
• 数据导出模板：报表导出的格式模板
• 打印模板：合同、发票等文档的打印模板

总结

文件模板管理模块提供模板文件的 CRUD 管理能力，为数据导入导出、打印等业务场景提供模板支持。