rui/rui-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
90 Commits 1 Branch 0 Tags
main
Commit Graph

15 Commits

Author SHA1 Message Date
vifo 7fdd93fc4b docs: 补充支付设计文档、store 字段设计文档及实施计划 2026-06-09 02:02:21 +08:00
vifo a79be07c52 docs: 新增 api-portal API 文档门户设计文档 2026-06-09 01:56:37 +08:00
vifo f4761ae145 docs(spec): add SysApp application integration management design 
- 为 rui/rui-frontend#4 工单编写设计规范
- 7 个文件变更：service 新建、index 改、router 改、locales 改、2 个 vue 新建
- 4 Tab 表单布局（基础信息/凭证信息/接口配置/高级）
- 敏感字段脱敏（appSecret/appKey/aesKey）
- certificates 字段 JSON 占位（等 rui/rui-framework#4 文件上传接口）

对应工单 rui/rui-frontend#4
 2026-06-08 11:23:17 +08:00
vifo bb71263bdd docs: add superpowers design docs and plans 2026-06-08 11:23:17 +08:00
vifo 9957d85595 docs: 添加前后端智能协作方案设计文档 2026-06-08 11:23:17 +08:00
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
vifo 4271f333b6 docs(specs): 更新已完成 spec 文档状态 
- 2026-06-07-sys-app-management: 已批准，待实现 → 已实现
- 2026-06-07-multi-login-social-login: 已批准，待实现 → 已实现
- 2026-06-06-user-aggregate-query: 已批准 → 已实现

各 spec 对应的 plan 已结清/实施 commit 已落地，更新状态描述并补充实施情况指引。
 2026-06-07 18:46:30 +08:00
vifo 22889afedc docs(spec): 用 appId 作为唯一标识（来自 X-App-Id 请求头） 
原方案用 platform 作为缓存 key 错误：
- 多个租户都叫 platform=wechat，缓存 key 冲突
- platform 不是真正唯一标识

按用户反馈调整：
- 凭证查询/缓存全部用 appId
- appId 来源：请求头 X-App-Id
- §3.1 加 UNIQUE KEY uk_app_id (app_id) 约束
- §5.1 流程重写：从 X-App-Id 取 appId → 缓存 key = app:creds:{appId}
- §5.2/5.3 删缓存也改用 appId
- §7.1 OAuth2 改造：从 request.getHeader("X-App-Id") 取
- 删除 §1.2 中 'client_id 映射' 的旧说法
 2026-06-07 17:08:32 +08:00
vifo c576053ab6 docs(spec): SysApp 简化为单密钥列 + 多证书 JSON 数组 
按用户反馈调整：
- 删除：app_secret_text / app_secret_file_path / private/public_key 的 text+file_path
- 新增：certificates JSON（多 p12 证书，每项含 name/path/password）
- 简单凭证（app_id/app_secret/app_key/aes_key）保留单值 VARCHAR 列
- §2 原则 4 改为'简单文本用列 / 多证书用 JSON'
 2026-06-07 17:02:06 +08:00
vifo 33690fe80b docs(spec): 第三方应用管理（SysApp）设计规格 
- 新增 SysApp 实体：多租户第三方应用凭证管理
- 平台元数据 + 支付扩展 + AES key + 证书/文本分离
- 消费方：OAuth2ServerConfig Feign + Redis 30min 缓存
- 租户隔离：owner_type=PLATFORM/TENANT + client_id→tenant_id 映射
- 范围：不涉及 rui-service-user（user 模块）
 2026-06-07 16:53:36 +08:00
vifo 84b3bb601e docs(spec): 添加多方式登录与第三方登录设计规格 (已批准) 2026-06-07 15:32:26 +08:00
vifo de78c21799 docs(spec): 更新用户聚合查询设计规格 
- 添加 phone 字段迁移到 uc_user 表的设计
- 新增统一认证接口 /user/inner/auth/load（POST）
- 支持 AccountType 枚举：USERNAME/PHONE/EMAIL
- 废弃旧的 loadByUsername 接口
- 添加数据库变更 SQL 脚本
 2026-06-06 13:30:23 +08:00
vifo a8c164459a docs(spec): 用户聚合查询设计规格 
- 方案B：后端聚合查询 + Redis缓存
- 新增聚合接口 /user/admin/user/{id}/aggregate
- 批量列表查询优化，避免N+1
- 缓存策略与失效机制设计
- 保持向后兼容
 2026-06-06 13:14:13 +08:00