签入版本

2026-09-16 13:28:20 +08:00
parent 6cd5e80de0
commit c97d87847f
410 changed files with 68726 additions and 0 deletions
@@ -0,0 +1,51 @@
+# 文件模板管理
+
+:::tip 说明
+文件模板管理模块提供文件导入导出模板的管理能力，用于维护各种业务场景的 Excel/Word 等模板文件。模块位于 `src/modules/file_template/`。
+:::
+
+## 模块结构
+
+```
+src/modules/file_template/
+├── models.py         # 模板模型
+├── schemas.py        # 参数验证
+├── repository.py     # 数据访问层
+├── service.py        # 业务逻辑层
+└── handlers.py       # 请求处理器
+```
+
+## 数据模型
+
+```python
+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 管理能力，为数据导入导出、打印等业务场景提供模板支持。