refactor: 全局替换 spring-ai -> rui-framework

同步仓库名称变更，涉及 16 个文件 66 处引用： - ai-skills: 菜单配置 - backend/guides: AI操作手册、环境配置、部署、gitnexus、opencode 工作流 - backend: 模块创建规则、通信规范、协作工作流、实施规范 - frontend: 收银设计、管理后台实施计划 - standards: 数据库设计规范
2026-06-08 12:56:39 +08:00
parent 12a263c451
commit a7f3ee3565
16 changed files with 66 additions and 66 deletions
@@ -64,4 +64,4 @@

 - 由**超级租户**读取 JSON 配置并初始化到数据库
 - 不需要编写 SQL 脚本或 Java 初始化代码
- 修改 JSON 后提交到 spring-ai 仓库即可
+- 修改 JSON 后提交到 rui-framework 仓库即可
@@ -660,5 +660,5 @@ private Long id;

 > **文档版本**: v1.0
 > **创建日期**: 2026-05-28
-> **适用范围**: spring-ai 项目数据库设计
+> **适用范围**: rui-framework 项目数据库设计
 > **状态**: 仅规划，未实施
@@ -11,7 +11,7 @@
 │   ├── cashier-mobile/
 │   └── customer-mobile/
 │
-├── spring-ai/             ← 后端框架 AI 工作目录
+├── rui-framework/             ← 后端框架 AI 工作目录
 │   ├── backend/
 │   │   ├── rui-common/
 │   │   ├── rui-gateway/
@@ -19,7 +19,7 @@
 │   │   └── rui-service/
 │   └── docs/
 │
-├── spring-ai/app/
+├── rui-framework/app/
 │   ├── rui-cashier/       ← 收银 AI 工作目录
 │   └── rui-payment/       ← 支付 AI 工作目录
 │
@@ -70,12 +70,12 @@ cd ~/rhkj/rui-frontend

 ### 后端框架 AI

-**工作目录：** `~/rhkj/spring-ai`
+**工作目录：** `~/rhkj/rui-framework`

 **启动步骤：**
 ```bash
 # 1. 进入后端目录
-cd ~/rhkj/spring-ai
+cd ~/rhkj/rui-framework

 # 2. 打开 OpenCode

@@ -84,7 +84,7 @@ cd ~/rhkj/spring-ai

 **AI 指令：**
 ```
-你是 Java 后端开发专家。当前项目是 spring-ai（睿核科技后端框架）。
+你是 Java 后端开发专家。当前项目是 rui-framework（睿核科技后端框架）。

 技术栈：Spring Boot 3.x + Spring Cloud + JDK 21 + Maven + MyBatis Plus

@@ -108,12 +108,12 @@ cd ~/rhkj/spring-ai

 ### 收银模块 AI

-**工作目录：** `~/rhkj/spring-ai/app/rui-cashier`
+**工作目录：** `~/rhkj/rui-framework/app/rui-cashier`

 **启动步骤：**
 ```bash
 # 1. 进入收银模块目录
-cd ~/rhkj/spring-ai/app/rui-cashier
+cd ~/rhkj/rui-framework/app/rui-cashier

 # 2. 打开 OpenCode

@@ -135,7 +135,7 @@ cd ~/rhkj/spring-ai/app/rui-cashier

 约束条件：
 - 禁止修改前端代码
- 禁止修改框架代码（在 spring-ai 仓库）
+- 禁止修改框架代码（在 rui-framework 仓库）
 - 禁止直接引用支付模块代码
 - 通过 FeignClient 调用框架服务
 - 通过 REST API 暴露接口供前端调用
@@ -148,12 +148,12 @@ cd ~/rhkj/spring-ai/app/rui-cashier

 ### 支付模块 AI

-**工作目录：** `~/rhkj/spring-ai/app/rui-payment`
+**工作目录：** `~/rhkj/rui-framework/app/rui-payment`

 **启动步骤：**
 ```bash
 # 1. 进入支付模块目录
-cd ~/rhkj/spring-ai/app/rui-payment
+cd ~/rhkj/rui-framework/app/rui-payment

 # 2. 打开 OpenCode

@@ -175,7 +175,7 @@ cd ~/rhkj/spring-ai/app/rui-payment

 约束条件：
 - 禁止修改前端代码
- 禁止修改框架代码（在 spring-ai 仓库）
+- 禁止修改框架代码（在 rui-framework 仓库）
 - 禁止直接引用收银模块代码
 - 通过 FeignClient 调用框架服务
 - 通过 REST API 暴露接口供收银模块调用
@@ -271,9 +271,9 @@ const cashierApi = {
 | 文件 | 位置 | 说明 |
 |------|------|------|
 | AI 边界配置 | `AGENTS.md` | 每个仓库根目录 |
-| 通信规范 | `spring-ai/docs/module-communication.md` | 模块间通信规范 |
+| 通信规范 | `rui-framework/docs/module-communication.md` | 模块间通信规范 |
 | CI 配置 | `.gitea/workflows/*.yml` | 自动化构建 |
-| 后端 POM | `spring-ai/backend/pom.xml` | Maven 根配置 |
+| 后端 POM | `rui-framework/backend/pom.xml` | Maven 根配置 |

 ---

@@ -169,7 +169,7 @@ npx gitnexus list
 ```
  Indexed Repositories (2)

-  spring-ai
+  rui-framework
    Path:    ~/work/rui-framework
    Stats:   7504 symbols, 15350 edges

@@ -220,7 +220,7 @@ AI：基于 rui-payment 索引分析...
 ```
 gitnexus_context({
  name: "AuthUtil",
-  repo: "spring-ai"
+  repo: "rui-framework"
 })
 ```

@@ -228,7 +228,7 @@ gitnexus_context({
 ```
 gitnexus_query({
  query: "分布式锁 Redisson",
-  repo: "spring-ai"
+  repo: "rui-framework"
 })
 ```

@@ -236,7 +236,7 @@ gitnexus_query({
 ```
 gitnexus_impact({
  target: "BaseController",
-  repo: "spring-ai",
+  repo: "rui-framework",
  direction: "upstream"
 })
 ```
@@ -245,7 +245,7 @@ gitnexus_impact({
 ```
 gitnexus_query({
  query: "用户登录认证流程",
-  repo: "spring-ai"
+  repo: "rui-framework"
 })
 ```

@@ -253,9 +253,9 @@ gitnexus_query({

 | 我想查... | 命令 | 仓库 |
 |-----------|------|------|
-| `AuthUtil.getUserId()` 怎么用 | `gitnexus_context({name:"AuthUtil", repo:"spring-ai"})` | framework |
-| 业务异常怎么抛 | `gitnexus_query({query:"BizException", repo:"spring-ai"})` | framework |
-| 分布式锁怎么加 | `gitnexus_query({query:"Redisson分布式锁", repo:"spring-ai"})` | framework |
+| `AuthUtil.getUserId()` 怎么用 | `gitnexus_context({name:"AuthUtil", repo:"rui-framework"})` | framework |
+| 业务异常怎么抛 | `gitnexus_query({query:"BizException", repo:"rui-framework"})` | framework |
+| 分布式锁怎么加 | `gitnexus_query({query:"Redisson分布式锁", repo:"rui-framework"})` | framework |
 | 支付订单状态流转 | `gitnexus_query({query:"订单状态", repo:"rui-payment"})` | payment |
 | 修改订单会影响哪里 | `gitnexus_impact({target:"OrderService", direction:"upstream"})` | payment |
 | 收银台缓存策略 | `gitnexus_query({query:"缓存 CacheKeys", repo:"rui-cashier"})` | cashier |
@@ -274,11 +274,11 @@ gitnexus_query({
   AI：建议调用 AuthUtil.getUserId()...
   
 4. 员工：AuthUtil 有哪些方法？
-   【AI执行】gitnexus_context({name:"AuthUtil", repo:"spring-ai"})
+   【AI执行】gitnexus_context({name:"AuthUtil", repo:"rui-framework"})
   AI：AuthUtil 提供 getUserId()、getTenantId()、getUser()...

 5. 员工：退款金额用 BigDecimal 吗？
-   【AI执行】gitnexus_query({query:"金额计算 BigDecimal", repo:"spring-ai"})
+   【AI执行】gitnexus_query({query:"金额计算 BigDecimal", repo:"rui-framework"})
   AI：框架规范要求金额使用 DECIMAL(19,4)，Java 对应 BigDecimal...

 6. AI 生成完整代码
@@ -305,7 +305,7 @@ npx gitnexus analyze
 # 查看所有索引
 npx gitnexus list

-# 确认 spring-ai 存在
+# 确认 rui-framework 存在
 # 如果不存在，重新索引框架仓库
 cd ~/work/rui-framework
 npx gitnexus analyze
@@ -353,7 +353,7 @@ npx gitnexus analyze

 | 仓库路径 | 索引名称 | 说明 |
 |----------|----------|------|
-| `~/work/rui-framework` | `spring-ai` | 基于 pom.xml artifactId |
+| `~/work/rui-framework` | `rui-framework` | 基于 pom.xml artifactId |
 | `~/work/rui-payment` | `rui-payment` | 基于目录名 |
 | `~/work/rui-cashier` | `rui-cashier` | 基于目录名 |

@@ -40,7 +40,7 @@

 ```bash
 # 进入后端目录
-cd ~/rhkj/spring-ai/backend
+cd ~/rhkj/rui-framework/backend

 # Maven 打包
 mvn clean package -DskipTests
@@ -71,7 +71,7 @@ git --version

 ```bash
 git clone <repository-url>
-cd spring-ai
+cd rui-framework
 ```

 ### 2.2 配置本地开发环境
@@ -1,6 +1,6 @@
 # GitNexus — Code Intelligence 使用指南

-> **项目索引**: spring-ai (2690 symbols, 5387 relationships, 218 execution flows)
+> **项目索引**: rui-framework (2690 symbols, 5387 relationships, 218 execution flows)

 ## 基本概念

@@ -27,10 +27,10 @@ GitNexus 是一个代码智能工具，通过索引代码库构建知识图谱

 | Resource | Use for |
 |----------|---------|
-| `gitnexus://repo/spring-ai/context` | Codebase overview, check index freshness |
-| `gitnexus://repo/spring-ai/clusters` | All functional areas |
-| `gitnexus://repo/spring-ai/processes` | All execution flows |
-| `gitnexus://repo/spring-ai/process/{name}` | Step-by-step execution trace |
+| `gitnexus://repo/rui-framework/context` | Codebase overview, check index freshness |
+| `gitnexus://repo/rui-framework/clusters` | All functional areas |
+| `gitnexus://repo/rui-framework/processes` | All execution flows |
+| `gitnexus://repo/rui-framework/process/{name}` | Step-by-step execution trace |

 ## 技能参考

@@ -12,7 +12,7 @@ rui 项目采用**多仓库**架构：

 ```
 ~/rhkj/
-├── spring-ai/              # 后端仓库（Java/Spring）
+├── rui-framework/              # 后端仓库（Java/Spring）
 │   ├── backend/            # 基础框架
 │   ├── app/                # 应用模块
 │   └── docs/               # 文档
@@ -29,11 +29,11 @@ rui 项目采用**多仓库**架构：

 ## 二、启动 OpenCode 的正确姿势

-### 2.1 后端开发（spring-ai）
+### 2.1 后端开发（rui-framework）

 ```bash
 # 1. 进入后端目录
-cd /Users/zhangsheng/rhkj/spring-ai
+cd /Users/zhangsheng/rhkj/rui-framework

 # 2. 启动 OpenCode（命令行方式）
 opencode
@@ -46,7 +46,7 @@ opencode
 ```
 你现在进入【后端开发模式】。

-工作目录：/Users/zhangsheng/rhkj/spring-ai
+工作目录：/Users/zhangsheng/rhkj/rui-framework
 负责范围：backend/ 和 app/ 目录下的 Java 代码
 技术栈：Spring Boot 4.x、Spring Cloud、MyBatis Plus、JDK 21

@@ -83,7 +83,7 @@ opencode

 规则：
 1. 只能修改前端项目下的代码
-2. 需要后端接口时，在 spring-ai 仓库创建 Gitee Issue
+2. 需要后端接口时，在 rui-framework 仓库创建 Gitee Issue
 3. 编码规范参考 AGENTS.md
 4. 使用 pnpm workspace 管理多项目

@@ -97,7 +97,7 @@ opencode
 ```
 你现在进入【框架开发模式】。

-工作目录：/Users/zhangsheng/rhkj/spring-ai
+工作目录：/Users/zhangsheng/rhkj/rui-framework
 负责范围：仅 backend/ 目录
 角色：基础框架维护者

@@ -170,7 +170,7 @@ AI：好的，开始开发前端页面...

 OpenCode 应该回答：
 ```
-请在 spring-ai 仓库创建 Issue，使用模板：api_request.md
+请在 rui-framework 仓库创建 Issue，使用模板：api_request.md

 Issue 内容：
 标题：[API-REQ] 用户模块需要批量导入接口
@@ -229,11 +229,11 @@ OpenCode 应该：

 **答**：
 1. **方法 A（推荐）**：先在一个仓库完成，提交后切换到另一个仓库
-   - 在 spring-ai 开发接口 → 提交 PR
+   - 在 rui-framework 开发接口 → 提交 PR
   - 在 rui-frontend 开发页面 → 提交 PR
   
 2. **方法 B（并行）**：两个 OpenCode 窗口同时工作
-   - 窗口 1：spring-ai 目录，开发后端
+   - 窗口 1：rui-framework 目录，开发后端
   - 窗口 2：rui-frontend 目录，开发前端
   
 3. **不要**：在一个会话中同时修改两个仓库
@@ -293,7 +293,7 @@ OpenCode 应该：
 **后端启动模板**：
 ```markdown
 你现在进入【后端开发模式】。
-工作目录：/Users/zhangsheng/rhkj/spring-ai
+工作目录：/Users/zhangsheng/rhkj/rui-framework
 技术栈：Spring Boot 4.x、JDK 21、MyBatis Plus
 规则：只能修改 backend/ 和 app/ 目录
 当前任务：【填写】
@@ -241,7 +241,7 @@ GITEA_URL="https://git.vifo.cc"
 GITEA_TOKEN="your-token"
 GITEA_ORG="rui"

-REPOS=("spring-ai" "rui-frontend" "rui-payment")
+REPOS=("rui-framework" "rui-frontend" "rui-payment")

 for repo in "${REPOS[@]}"; do
    echo "迁移: $repo"
@@ -334,7 +334,7 @@ jobs:
 ### 5.4 创建后端 CI/CD 工作流

 ```yaml
-# spring-ai/.gitea/workflows/build.yml
+# rui-framework/.gitea/workflows/build.yml
 name: Build and Test

 on:
@@ -218,7 +218,7 @@ git push -u origin master
 ### 与框架主仓库的关系

 ```
-spring-ai/                          # 框架主仓库（git）
+rui-framework/                          # 框架主仓库（git）
 ├── backend/                        # 提交到框架仓库
 ├── docs/                           # 提交到框架仓库
 ├── app/                            # 不提交到框架仓库（.gitignore）
@@ -9,7 +9,7 @@

 ## 🔗 通信方式

-### 1. 模块 → 框架（spring-ai）
+### 1. 模块 → 框架（rui-framework）

 ```java
 // 使用 FeignClient 调用框架服务
@@ -11,7 +11,7 @@
 ### 1.1 问题背景

 rui 项目采用多仓结构：
- **后端仓库**：`spring-ai`（backend + app/*）
+- **后端仓库**：`rui-framework`（backend + app/*）
 - **前端仓库**：`rui-frontend`（admin-ui + cashier-mobile + customer-mobile）

 在使用 OpenCode AI 辅助开发时存在以下痛点：
@@ -35,8 +35,8 @@ rui 项目采用多仓结构：
 ### 2.1 仓库结构

 ```
-# 后端仓库：spring-ai
-spring-ai/
+# 后端仓库：rui-framework
+rui-framework/
 ├── backend/              # 基础框架
 ├── app/                  # 应用模块（支付、收银等）
 ├── docs/                 # 后端文档
@@ -54,8 +54,8 @@ rui-frontend/

 | 角色 | 所属仓库 | 负责目录 | 可修改范围 | 只读范围 | 会话配置 |
 |------|---------|---------|-----------|---------|---------|
-| **框架开发** | spring-ai | `backend/` | `backend/**` | `app/**` | `framework.json` |
-| **应用开发** | spring-ai | `app/{模块}/` | `app/{模块}/**` | `backend/**` | `app-module.json` |
+| **框架开发** | rui-framework | `backend/` | `backend/**` | `app/**` | `framework.json` |
+| **应用开发** | rui-framework | `app/{模块}/` | `app/{模块}/**` | `backend/**` | `app-module.json` |
 | **前端开发** | rui-frontend | `admin-ui/` | `admin-ui/**` | `cashier-mobile/`, `customer-mobile/` | `admin-ui.json` |

 ### 2.2 职责矩阵
@@ -80,13 +80,13 @@ rui-frontend/
 **协作流程**（跨仓库协作）：

 ```
-rui-frontend/              spring-ai/
+rui-frontend/              rui-framework/
 ┌─────────────┐           ┌─────────────┐
 │  前端会话    │           │    后端      │
 │  (admin-ui) │           │   会话       │
 └──────┬──────┘           └──────┬──────┘
       │                         │
-       │  在 spring-ai 仓库创建   │
+       │  在 rui-framework 仓库创建   │
       │  Issue [API-REQ]        │
       └────────────────────────→│
       │                         │
@@ -210,9 +210,9 @@ rui-frontend/              spring-ai/

 启动 OpenCode 时，明确指定仓库和角色：

-**后端仓库（spring-ai）**：
+**后端仓库（rui-framework）**：
 ```
-工作目录：/Users/zhangsheng/rhkj/spring-ai
+工作目录：/Users/zhangsheng/rhkj/rui-framework
 角色：框架开发
 限制：只能修改 backend/ 下的代码
 ```
@@ -367,7 +367,7 @@ rui-frontend/              spring-ai/
 - 需要评估影响范围
 - 需要同步版本更新

-### Q2: 前端仓库（rui-frontend）和后端仓库（spring-ai）是什么关系？
+### Q2: 前端仓库（rui-frontend）和后端仓库（rui-framework）是什么关系？

 **答**：
 - **独立仓库**：前端和后端是完全独立的 Git 仓库
@@ -1,6 +1,6 @@
 # 睿核科技 (rui) — 项目实施规范

-> 本文档基于对当前 spring-ai 项目的全面分析，整理项目结构、业务流、现有规范、推荐修改项及缺少的专业结构，供后续项目实施参考。
+> 本文档基于对当前 rui-framework 项目的全面分析，整理项目结构、业务流、现有规范、推荐修改项及缺少的专业结构，供后续项目实施参考。

 ---

@@ -8,7 +8,7 @@

 | 项目属性 | 值 |
 |---------|-----|
-| **项目名称** | spring-ai |
+| **项目名称** | rui-framework |
 | **项目类型** | Spring Cloud 微服务架构（通用平台框架） |
 | **组织方式** | Monorepo（backend + 可扩展前端） |
 | **JDK** | 21 |
@@ -436,5 +436,5 @@

 > **文档版本**: v1.0
 > **创建日期**: 2026-05-28
-> **适用范围**: spring-ai 项目及后续同类项目
+> **适用范围**: rui-framework 项目及后续同类项目
 > **维护方式**: 随项目实施迭代更新
@@ -34,7 +34,7 @@
 | 后端 | `ssh://git@git.dev.vifo.cc:222/rui/rui-cashier.git` | 收银系统独立后端服务 |
 | 文档 | `ssh://git@git.dev.vifo.cc:222/rui/rui-docs.git` | 共享文档中心 |

-> ⚠️ **注意**：收银系统相关 Issue 应提交到 `rui/rui-cashier` 仓库，不是 `spring-ai`
+> ⚠️ **注意**：收银系统相关 Issue 应提交到 `rui/rui-cashier` 仓库，不是 `rui-framework`

 ### 2.2 菜单数据结构

@@ -252,7 +252,7 @@ Add dialog component in template:

 Run:
 ```bash
-cd /Users/zhangsheng/rhkj/spring-ai/admin-ui
+cd /Users/zhangsheng/rhkj/rui-framework/admin-ui
 pnpm dev:cashier
 ```

@@ -1293,7 +1293,7 @@ git commit -m "feat(cashier): 完善订单管理开台功能"

 Install echarts if not already installed:
 ```bash
-cd /Users/zhangsheng/rhkj/spring-ai/admin-ui
+cd /Users/zhangsheng/rhkj/rui-framework/admin-ui
 pnpm add echarts vue-echarts
 ```

@@ -1322,7 +1322,7 @@ git commit -m "feat(cashier): 优化营业报表图表展示"

 Run:
 ```bash
-cd /Users/zhangsheng/rhkj/spring-ai/admin-ui
+cd /Users/zhangsheng/rhkj/rui-framework/admin-ui
 pnpm build:cashier
 ```

@@ -1,6 +1,6 @@
 # 数据库设计规范分析报告

-> 基于对当前 spring-ai 项目数据库设计的全面审查，本报告列出所有不合理之处及专业改进方案。
+> 基于对当前 rui-framework 项目数据库设计的全面审查，本报告列出所有不合理之处及专业改进方案。
 > **注意：本报告仅做分析，不做任何代码实施。**

 ---