vifo
22889afedc
原方案用 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 映射' 的旧说法
Rui-Docs
睿核科技项目文档中心 —— 前后端共享的独立文档仓库
📁 目录结构
rui-docs/
├── README.md # 本文档
├── standards/ # 通用规范（前后端共享）
│ ├── API设计规范.md
│ ├── 前端开发规则.md
│ ├── 数据库设计规范分析.md
│ └── coding-standards.md
├── backend/ # 后端相关文档
│ ├── design/ # 设计文档
│ ├── specs/ # 规格说明
│ ├── guides/ # 操作指南
│ │ ├── AI开发操作手册.md
│ │ └── deployment-guide.md
│ ├── 模块间通信规范.md
│ ├── 跨团队协作工作流.md
│ ├── 项目实施规范.md
│ └── 业务应用模块创建规则.md
└── frontend/ # 前端相关文档
├── design/ # 设计文档
├── specs/ # 规格说明
├── plans/ # 实施计划
├── admin-ui-icon-guide.md
└── admin-ui-status.md
🔗 使用方式
作为 Git Submodule
在代码仓库中添加文档子模块：
# 添加 submodule
git submodule add ssh://git@git.dev.vifo.cc:222/rui/rui-docs.git docs
# 更新到最新
git submodule update --remote
# 初始化（新克隆时）
git submodule update --init --recursive
独立查看
git clone ssh://git@git.dev.vifo.cc:222/rui/rui-docs.git
cd rui-docs
📋 文档索引
前端设计文档（frontend/design/）
| 文档 | 说明 | 更新日期 |
|---|---|---|
rui-admin功能设计文档.md |
rui-admin 管理后台功能模块设计 | 2026-06-03 |
cashier-design.md |
收银系统（POS）整体架构设计 | 2026-06-03 |
admin-ui-module-build-design.md |
Admin-UI 分模块打包功能设计 | 2026-06-04 |
前端实施计划（frontend/plans/）
| 文档 | 说明 | 更新日期 |
|---|---|---|
cashier-admin-implementation.md |
收银系统后台管理功能完善实施计划 | 2026-06-04 |
后端文档（backend/）
| 文档 | 说明 | 更新日期 |
|---|---|---|
模块间通信规范.md |
微服务模块间通信规范（Feign/REST） | 2026-06-04 |
跨团队协作工作流.md |
多团队/多 AI 协作流程规范 | 2026-06-04 |
项目实施规范.md |
项目整体实施规范与架构说明 | 2026-06-04 |
业务应用模块创建规则.md |
业务模块（app/）创建标准 | 2026-06-04 |
guides/AI开发操作手册.md |
AI 开发环境配置与操作指南 | 2026-06-04 |
guides/deployment-guide.md |
项目部署指南 | 2026-06-04 |
前端文档（frontend/）
| 文档 | 说明 | 更新日期 |
|---|---|---|
admin-ui-icon-guide.md |
Admin-UI 图标使用指南 | 2026-06-04 |
admin-ui-status.md |
Admin-UI 状态管理文档 | 2026-06-04 |
通用规范（standards/）
| 文档 | 说明 |
|---|---|
API设计规范.md |
RESTful API 设计规范 |
前端开发规则.md |
前端编码规范、目录结构、命名约定 |
数据库设计规范分析.md |
数据库设计规范与约束 |
coding-standards.md |
通用编码规范（Java/TypeScript） |
🔄 文档维护规范
- 文档即代码：所有文档使用 Markdown 格式，纳入版本控制
- 单一数据源：本文档仓库是唯一的文档源头，代码仓库通过 submodule 引用
- 变更追溯：文档修改需通过 PR/MR 流程，保留修改历史
- 定期同步：代码仓库的 submodule 应定期更新到最新文档版本
📝 新增文档流程
- 在本文档仓库的对应目录下创建
.md文件 - 提交并推送到远程
- 在代码仓库中执行
git submodule update --remote获取更新
👥 参与人员
- 前端开发：关注
frontend/目录 - 后端开发：关注
backend/目录 - 架构师/全栈：关注
standards/目录
📧 文档问题请联系项目维护者