diff --git a/ai-skills/menu-config.md b/ai-skills/menu-config.md index b58c9f4..221bddc 100644 --- a/ai-skills/menu-config.md +++ b/ai-skills/menu-config.md @@ -64,4 +64,4 @@ - 由**超级租户**读取 JSON 配置并初始化到数据库 - 不需要编写 SQL 脚本或 Java 初始化代码 -- 修改 JSON 后提交到 spring-ai 仓库即可 +- 修改 JSON 后提交到 rui-framework 仓库即可 diff --git a/backend/design/数据库表结构规划.md b/backend/design/数据库表结构规划.md index 3ad3cfe..d2ab063 100644 --- a/backend/design/数据库表结构规划.md +++ b/backend/design/数据库表结构规划.md @@ -660,5 +660,5 @@ private Long id; > **文档版本**: v1.0 > **创建日期**: 2026-05-28 -> **适用范围**: spring-ai 项目数据库设计 +> **适用范围**: rui-framework 项目数据库设计 > **状态**: 仅规划,未实施 diff --git a/backend/guides/AI开发操作手册.md b/backend/guides/AI开发操作手册.md index 8d9c770..2f22d3f 100644 --- a/backend/guides/AI开发操作手册.md +++ b/backend/guides/AI开发操作手册.md @@ -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 根配置 | --- diff --git a/backend/guides/AI开发环境配置手册.md b/backend/guides/AI开发环境配置手册.md index a068662..92b871c 100644 --- a/backend/guides/AI开发环境配置手册.md +++ b/backend/guides/AI开发环境配置手册.md @@ -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` | 基于目录名 | diff --git a/backend/guides/deployment-guide.md b/backend/guides/deployment-guide.md index 0d1a462..5fa45cc 100644 --- a/backend/guides/deployment-guide.md +++ b/backend/guides/deployment-guide.md @@ -40,7 +40,7 @@ ```bash # 进入后端目录 -cd ~/rhkj/spring-ai/backend +cd ~/rhkj/rui-framework/backend # Maven 打包 mvn clean package -DskipTests diff --git a/backend/guides/environment-setup.md b/backend/guides/environment-setup.md index 5bc6c9a..a063687 100644 --- a/backend/guides/environment-setup.md +++ b/backend/guides/environment-setup.md @@ -71,7 +71,7 @@ git --version ```bash git clone -cd spring-ai +cd rui-framework ``` ### 2.2 配置本地开发环境 diff --git a/backend/guides/gitnexus-guide.md b/backend/guides/gitnexus-guide.md index 6810386..cbc5e4c 100644 --- a/backend/guides/gitnexus-guide.md +++ b/backend/guides/gitnexus-guide.md @@ -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 | ## 技能参考 diff --git a/backend/guides/opencode-workflow.md b/backend/guides/opencode-workflow.md index 116d4e0..048dc54 100644 --- a/backend/guides/opencode-workflow.md +++ b/backend/guides/opencode-workflow.md @@ -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/ 目录 当前任务:【填写】 diff --git a/backend/guides/self-hosted-git-server.md b/backend/guides/self-hosted-git-server.md index b781c68..41df29d 100644 --- a/backend/guides/self-hosted-git-server.md +++ b/backend/guides/self-hosted-git-server.md @@ -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: diff --git a/backend/业务应用模块创建规则.md b/backend/业务应用模块创建规则.md index 00d623d..6de9c26 100644 --- a/backend/业务应用模块创建规则.md +++ b/backend/业务应用模块创建规则.md @@ -218,7 +218,7 @@ git push -u origin master ### 与框架主仓库的关系 ``` -spring-ai/ # 框架主仓库(git) +rui-framework/ # 框架主仓库(git) ├── backend/ # 提交到框架仓库 ├── docs/ # 提交到框架仓库 ├── app/ # 不提交到框架仓库(.gitignore) diff --git a/backend/模块间通信规范.md b/backend/模块间通信规范.md index 7d3bfe0..3ee3f1b 100644 --- a/backend/模块间通信规范.md +++ b/backend/模块间通信规范.md @@ -9,7 +9,7 @@ ## 🔗 通信方式 -### 1. 模块 → 框架(spring-ai) +### 1. 模块 → 框架(rui-framework) ```java // 使用 FeignClient 调用框架服务 diff --git a/backend/跨团队协作工作流.md b/backend/跨团队协作工作流.md index 2433ca7..f48b4b6 100644 --- a/backend/跨团队协作工作流.md +++ b/backend/跨团队协作工作流.md @@ -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 仓库 diff --git a/backend/项目实施规范.md b/backend/项目实施规范.md index 644cd49..63cd1e9 100644 --- a/backend/项目实施规范.md +++ b/backend/项目实施规范.md @@ -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 项目及后续同类项目 > **维护方式**: 随项目实施迭代更新 diff --git a/frontend/design/cashier-design.md b/frontend/design/cashier-design.md index 8648247..39d45c6 100644 --- a/frontend/design/cashier-design.md +++ b/frontend/design/cashier-design.md @@ -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 菜单数据结构 diff --git a/frontend/plans/cashier-admin-implementation.md b/frontend/plans/cashier-admin-implementation.md index 96d2439..45e9547 100644 --- a/frontend/plans/cashier-admin-implementation.md +++ b/frontend/plans/cashier-admin-implementation.md @@ -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 ``` diff --git a/standards/数据库设计规范分析.md b/standards/数据库设计规范分析.md index 0c0261f..66406b0 100644 --- a/standards/数据库设计规范分析.md +++ b/standards/数据库设计规范分析.md @@ -1,6 +1,6 @@ # 数据库设计规范分析报告 -> 基于对当前 spring-ai 项目数据库设计的全面审查,本报告列出所有不合理之处及专业改进方案。 +> 基于对当前 rui-framework 项目数据库设计的全面审查,本报告列出所有不合理之处及专业改进方案。 > **注意:本报告仅做分析,不做任何代码实施。** ---