41 lines
1.1 KiB
Markdown
41 lines
1.1 KiB
Markdown
# 系统基础模块后端实现
|
||
|
||
## 1. 包结构
|
||
|
||
当前实现位于 `com.bruce.common`：
|
||
|
||
- `controller`：枚举和附件 API。
|
||
- `domain/entity`：`SysEnum`、`SysAttachment`。
|
||
- `domain/model`：`BaseEntity`、`RequestResult`。
|
||
- `document/parse`：文档解析抽象和 Tika 实现。
|
||
- `enums`：通用枚举与可持久化枚举契约。
|
||
- `service`：枚举与附件服务。
|
||
|
||
## 2. Controller 约定
|
||
|
||
Controller 只接收请求 DTO 或基础参数，不直接暴露实体。响应统一使用 `RequestResult<T>`。
|
||
|
||
## 3. Service 约定
|
||
|
||
`SysEnumService` 负责：
|
||
|
||
- 管理端查询。
|
||
- 单条保存和删除。
|
||
- 批量保存。
|
||
- 按 `catalog + type` 全量替换初始化。
|
||
|
||
`SysAttachmentService` 负责：
|
||
|
||
- 校验上传文件。
|
||
- 生成存储路径。
|
||
- 保存本地文件。
|
||
- 写入附件元数据。
|
||
|
||
## 4. 后续实现注意
|
||
|
||
- 不调整 `PersistableSysEnumDefinition` 现有方法。
|
||
- 不调整 `sys_enum` 表字段。
|
||
- 新增枚举时同步初始化测试和 SQL 初始化脚本。
|
||
- 文档解析器新增类型时，只扩展解析器实现和工厂注册，不影响 RAG 业务服务。
|
||
|