rui-docs

rui/rui-docs

Fork 0

Commit Graph

Author	SHA1	Message	Date
vifo	f26c67368c	docs(spec): 上传 API 增加 fileName + extract=zip 自动解压 - §7.1 补充 fileName (可选)、extract (bool) - 响应统一为 Result<List<SysFileUploadVO>>：单文件也是长度 1 的数组 - §7.4 fileName 行为说明 (不传/传/校验) - §7.5 extract=true (ZIP 解压)： - 行为 + 路径规则 (bizType/zipBaseName/entryName) - 安全护栏 (总 entry ≤ 100, 单 entry ≤ maxSize, entry 名正则) - 请求/响应/订阅方事件示例 - 对应后端 commit: c4a5d5f	2026-06-07 23:17:14 +08:00
vifo	3aebe0b5a5	docs(spec/plan): FileBizType 改为工具类（非枚举），bizType 自由字符串设计调整原因：上传服务是统一基础设施，强制枚举会要求「加新模块 = 改框架代码」。改为 final class + normalize() 格式校验，业务模块自定 bizType 字符串即可。 - spec §4.2: 整个 FileBizType 章节重写（工具类 + 格式约束 + 设计意图） - spec flow 5/11: 校验从 values() 改为 normalize() - spec API 表 / 代码结构表 / 订阅方示例同步更新 - plan Step 1.2/1.4 / 状态表 / 流程校验 / 发布器签名同步更新	2026-06-07 22:44:12 +08:00
vifo	66f0712486	docs(spec): 文件存储服务（rui-service-storage）设计文档 - 独立微服务 rui-service-storage 统一上传接口 - 支持阿里云 OSS / 腾讯云 COS / 本地 Strategy - 内置 @AutoPermission 鉴权 - Redis pub/sub ON_UPLOAD / ON_FILE_DELETED 事件 - topic 常量集中在 rui-common-core/.../constants/MqTopicConstants - 关联 Gitea #4	2026-06-07 21:25:31 +08:00

Author

SHA1

Message

Date

vifo

f26c67368c

docs(spec): 上传 API 增加 fileName + extract=zip 自动解压

- §7.1 补充 fileName (可选)、extract (bool)
- 响应统一为 Result<List<SysFileUploadVO>>：单文件也是长度 1 的数组
- §7.4 fileName 行为说明 (不传/传/校验)
- §7.5 extract=true (ZIP 解压)：
  - 行为 + 路径规则 (bizType/zipBaseName/entryName)
  - 安全护栏 (总 entry ≤ 100, 单 entry ≤ maxSize, entry 名正则)
  - 请求/响应/订阅方事件示例
- 对应后端 commit: c4a5d5f

2026-06-07 23:17:14 +08:00

vifo

3aebe0b5a5

docs(spec/plan): FileBizType 改为工具类（非枚举），bizType 自由字符串

设计调整原因：上传服务是统一基础设施，强制枚举会要求「加新模块 = 改框架代码」。
改为 final class + normalize() 格式校验，业务模块自定 bizType 字符串即可。

- spec §4.2: 整个 FileBizType 章节重写（工具类 + 格式约束 + 设计意图）
- spec flow 5/11: 校验从 values() 改为 normalize()
- spec API 表 / 代码结构表 / 订阅方示例 同步更新
- plan Step 1.2/1.4 / 状态表 / 流程校验 / 发布器签名 同步更新

2026-06-07 22:44:12 +08:00

vifo

66f0712486

docs(spec): 文件存储服务（rui-service-storage）设计文档

- 独立微服务 rui-service-storage 统一上传接口
- 支持阿里云 OSS / 腾讯云 COS / 本地 Strategy
- 内置 @AutoPermission 鉴权
- Redis pub/sub ON_UPLOAD / ON_FILE_DELETED 事件
- topic 常量集中在 rui-common-core/.../constants/MqTopicConstants
- 关联 Gitea #4

2026-06-07 21:25:31 +08:00

3 Commits