# lambda-fusion

**Repository Path**: westboy/lambda-fusion-parent

## Basic Information

- **Project Name**: lambda-fusion
- **Description**: Lambda Fusion 是一个基于 lamuda-cloud-parent 的企业级业务快速开发框架，提供开箱即用的权限管理、配置管理、数据字典、AI 智能平台等核心业务功能，助力快速构建微服务应用。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: 2026.2
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 20
- **Forks**: 6
- **Created**: 2026-03-14
- **Last Updated**: 2026-08-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Java, Netty, SpringBoot, Spring, SpringCloud

## README

<div align="center">

<p align="center">
	<img alt="logo" src="assets/logo.png" width="250" height="250">
</p>

# 🚀 Lambda Fusion Framework

**基于 lambda-cloud 构建的全栈企业级微服务业务开发框架**

[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-4.x-brightgreen.svg)](https://spring.io/projects/spring-boot)
[![Spring Cloud](https://img.shields.io/badge/Spring%20Cloud-2025.1.x-brightblue.svg)](https://spring.io/projects/spring-cloud)
[![JDK](https://img.shields.io/badge/JDK-21+-orange.svg)](https://www.oracle.com/java/technologies/javase-downloads.html)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
   
</div>

---

## 📋 项目简介

Lambda Fusion 是以 [**lambda-cloud-parent**](https://gitee.com/westboy/lamuda-cloud-parent) 为基座的企业级业务开发框架，产出供下游应用依赖的 `lambda-fusion-*` starter 模块，提供开箱即用的权限管理、配置管理、数据字典、AI 智能平台等核心业务能力，助力快速构建微服务应用。

### ✨ 核心特性

- 🔐 **完善的权限体系** - RBAC 模型 + 轻量级多租户支持(字段级隔离)
- ⚙️ **动态配置管理** - 数据库配置源 + 热更新 + Nacos 发布
- 📚 **灵活的数据字典** - 静态/动态字典，枚举扫描注册
- 🤖 **AI 智能平台** - 基于 AgentScope 2.0：智能应用、LLM 管理、知识库 RAG、子代理、MCP、技能市场、通道网关
- 🎯 **开箱即用** - 预置常用业务模块，`lambda-fusion-startup` 一键组装运行


## 🏗️ 项目架构

采用模块化设计，各模块职责清晰，可按需引入：

```
lambda-fusion-parent/
├── 📦 lambda-fusion-bom/                  # BOM 依赖管理
├── 🎯 lambda-fusion-core/                 # 核心模块（分页/CRUD/树/字典/身份）
├── 🔐 lambda-fusion-authority-api/        # 权限 API（Dubbo 远程认证 + Sa-Token 适配）
├── 🔐 lambda-fusion-authority/            # 权限管理（用户、角色、组织、资源、租户、客户端）
├── 🛡️ lambda-fusion-permission/           # 权限控制（聚合模块）
│   ├── lambda-fusion-permission-api/          # API 权限元数据（client/server）
│   └── lambda-fusion-permission-datascope/    # 数据权限授权树
├── ⚙️ lambda-fusion-config/               # 配置管理（dbconfig + 热更新 + Nacos 发布）
├── 📚 lambda-fusion-dictionary/           # 数据字典（静态/动态字典、枚举扫描）
├── 🗄️ lambda-fusion-datasource/           # 动态数据源管理（server/client、Dubbo 分发）
├── 📤 lambda-fusion-oss/                  # 附件管理（七牛/S3，按租户隔离）
├── 🤖 lambda-fusion-ai/                   # AI 模块（基于 AgentScope 2.0）
└── 🚀 lambda-fusion-startup/              # 可运行演示应用（端口 20005）
```


## 🎯 核心功能
| 项目 | 说明 | 
|------|---------|
| 👤 **用户管理** | 用户信息维护、在线状态监控、密码策略管理 |
| 🎭 **角色管理** | 角色权限分配、角色组管理、角色继承 |
| 🏢 **组织架构** | 多层级组织结构、部门管理、岗位管理 |
| 📋 **资源管理** | 菜单权限、按钮权限、API 资源控制 |
| 🔑 **客户端管理** | 客户端管理、授权、访问控制 |
| 🏠 **多租户支持** | 单一共享库 + tenant_id 字段级隔离，会话/业务按租户过滤 |
| 🔒 **认证服务** | 用户认证、SSO 支持、动态菜单生成 |
| 🤖 **智能应用** | CHAT/WORKSPACE 两型、自演化、多沙箱后端、SSE 流式对话 |
| 🤖 **知识库 RAG** | 文档切块入库、pgvector 向量库、三种检索注入模式（GENERIC/AGENTIC/BOTH） |
| 🤖 **子代理 / 技能 / MCP / 通道** | DB 驱动子代理、技能市场、MCP 工具接入、钉钉/飞书/企微通道适配 |


## 🛠️ 技术栈

| 技术 | 版本     | 说明 |
|------|--------|------|
| ☕ **Java** | 21+    | 最新 LTS 版本，性能优异 |
| 🍃 **Spring Boot** | 4.0.2  | 微服务开发框架 |
| ☁️ **Spring Cloud** | 2025.1.x | 微服务生态组件 |
| 🔐 **Sa-Token** | Latest | 轻量级权限认证框架 |
| 💾 **MyBatis Plus** | Latest | 增强版 ORM 框架 |
| 🔄 **MapStruct** | Latest |高性能对象映射 |
| 🤖 **AgentScope** | 2.0 | AI 多智能体运行时（harness/模型/沙箱/通道/技能/RAG） |
| 🌶️ **Lombok** |Latest | 简化 Java 代码 |
| ☁️ **Nacos** |Latest | 配置中心 / 注册中心 |
| ☁️ **Dubbo** |Latest | 远程认证 / 数据源 / 权限元数据同步 |
| ☕ **Caffeine** |Latest | 高性能本地缓存 |
| 🔧 **Hutool** |Latest | Java 工具类库 |


## 🎨 预览与体验

* **演示地址**：[http://lambda.devcms.cn:20005/index.html](http://lambda.devcms.cn:20005/index.html)

* **账号密码**：`westboy` / `8a30d075d80fad0e799a6ac3a654a214`

## 🚀 快速开始

### 环境要求

- JDK 21+
- Maven 3.8+
- MySQL 8.0+ / PostgreSQL 12+
- Redis 6.0+

### 引入依赖

在项目 `pom.xml` 中添加：

```xml
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.lambda.cloud</groupId>
            <artifactId>lambda-fusion-bom</artifactId>
            <version>${lambda-fusion.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
```

### 使用模块

根据需要引入具体模块：

```xml
<!-- 权限管理 -->
<dependency>
    <groupId>com.lambda.cloud</groupId>
    <artifactId>lambda-fusion-authority</artifactId>
</dependency>

<!-- 配置管理 -->
<dependency>
    <groupId>com.lambda.cloud</groupId>
    <artifactId>lambda-fusion-config</artifactId>
</dependency>

<!-- 数据字典 -->
<dependency>
    <groupId>com.lambda.cloud</groupId>
    <artifactId>lambda-fusion-dictionary</artifactId>
</dependency>

<!-- AI 智能平台（基于 AgentScope 2.0） -->
<dependency>
    <groupId>com.lambda.cloud</groupId>
    <artifactId>lambda-fusion-ai</artifactId>
</dependency>
```

> 基座 `lambda-cloud-parent` 与 BOM 均为 `2026.1.1-SNAPSHOT`，需先在 `lamuda-cloud-parent` 下执行 `mvn clean install` 安装到本地仓库后再构建本仓库。运行演示见 `lambda-fusion-startup`（端口 20005，配置由环境变量驱动）。

### 构建与测试

本仓库没有 Maven wrapper，请使用系统 `mvn`（Maven 3.8+、JDK 21）。

```bash
# 构建 + 安装到本地仓库（在仓库根目录执行）
mvn clean install

# 仅构建单个模块及其 fusion 依赖（-am = 同时构建依赖）
mvn -pl lambda-fusion-authority -am clean install

# 仅编译（同时触发 Spotless 检查 + SpotBugs 检查，见「代码风格与静态检查」）
mvn -pl lambda-fusion-config compile

# 运行某模块的全部测试（目前仅 lambda-fusion-ai 有测试）
mvn -pl lambda-fusion-ai test

# 运行单个测试类 / 单个方法
mvn -pl lambda-fusion-ai test -Dtest=AgentGraphTest
mvn -pl lambda-fusion-ai test -Dtest=AgentGraphTest#shouldRoute
```

> 测试运行在 classpath 上而非 module path（父 POM 设置了 `surefire.useModulePath=false`），遇到 JPMS 相关测试失败时请留意。

### 代码风格与静态检查

父 POM 在 **`compile`** 阶段强制执行两道关卡，因此 `mvn compile` 就会在违规时失败：

- **Spotless - Palantir Java Format**（`PALANTIR` 风格，v2.67.0，不格式化 Javadoc）。自动修复：`mvn spotless:apply`；仅检查：`mvn spotless:check`。
- **SpotBugs** - compile 阶段 `check`，使用各模块 `spotbugs-exclude.xml`。根目录 `spotbugs.skip=false`；`lambda-fusion-ai` 设 `spotbugs.skip=true`，可按模块用 `-Dspotbugs.skip=true` 覆盖。

注解处理器由父 POM 装配：Lombok、MapStruct（+ `lombok-mapstruct-binding`）、`spring-boot-configuration-processor`，以及自定义 `lambda-cloud-processor`。`lombok.config`（`addLombokGeneratedAnnotation=true`）由 antrun 步骤在每次构建时重新生成，不要手动编辑。

### 运行启动演示模块

`lambda-fusion-startup` 把所有 fusion 模块组装成一个可运行的 Spring Boot 应用（`com.fusion.startup.FusionApplication`，端口 20005）。`application.yml` 中的运行时配置完全由环境变量驱动（如 `${MAIN_DB_URL}`、`${REDIS_HOST}`、`${QINIU_*}`、`${AI_*}`、`${ALIYUN_SMS_*}` 等），这些变量来自仓库根目录下本地、已 gitignore 的 `.evn` 文件（注意拼写，文件名就是 `.evn`）。**不要提交真实值**。

```bash
# 在 IDE 中运行 FusionApplication，或执行：
mvn -pl lambda-fusion-startup spring-boot:run
```

> 产出的 jar **未**经过 repackage、不可直接执行，因此除非自行添加 `spring-boot-maven-plugin` 的 repackage goal，否则 `java -jar` 无法运行。

## 📦 模块深度文档

每个模块在 `docs/skills/<module>/SKILL.md` 中有一份权威说明--包含自动配置入口、配置项、主要入口类、关键机制、条件装配说明，以及「常见改造入口」。修改模块前请先阅读对应的 SKILL.md；它会告诉你某类改动应具体触及哪些类。

覆盖模块：`lambda-fusion-ai` / `lambda-fusion-authority` / `lambda-fusion-authority-api` / `lambda-fusion-bom` / `lambda-fusion-config` / `lambda-fusion-core` / `lambda-fusion-datasource` / `lambda-fusion-dictionary` / `lambda-fusion-oss` / `lambda-fusion-permission` / `lambda-fusion-startup`。

## 🔧 OpenSpec 工作流（可选）

这是一套**可选的**规范驱动开发流程。`openspec` CLI 未随仓库分发，需开发者自行安装：`npm install -g @fission-ai/openspec`。相关 skills 与斜杠命令已暂存于 `.claude/skills/openspec-*`、`.claude/commands/opsx/` 与 `.trae/skills/openspec-*`（IDE 适配）。

**未安装该 CLI 时，`/opsx:*` 斜杠命令和 `openspec` 命令行调用不可用**；此时按常规方式直接修改代码即可。

若已安装 CLI，可由 `/opsx:*` 斜杠命令驱动：`/opsx:propose <name>` 创建变更脚手架、`/opsx:apply` 实现任务、`/opsx:archive` 归档、`/opsx:explore` / `/opsx:sync` 浏览与同步规范。进行中的变更位于 `openspec/changes/`；已归档规范位于 `openspec/specs/`。是否采用此流程由开发者自行决定。

---

## 📖 生态依赖

- **[lambda-cloud-parent](https://gitee.com/westboy/lambda-cloud-parent)** - 核心基座，封装底层自动化配置与基础工具类
- **[lambda-cloud-project-parent](https://gitee.com/westboy/lambda-cloud-project-parent)** - 统管项目依赖版本与 Maven 构建标准
- **[lambda-fusion-web](https://gitee.com/westboy/lambda-fusion-web)** - 基于 Vben Admin 构建的现代化前端界面


## 📚 相关资源

- 🎯 [实战项目示例](https://gitee.com/westboy/lambda-fusion-admin)


## 📄 开源协议

本项目基于 [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0) 开源协议。

**⭐ 如果这个项目对你有帮助，请给个 Star 支持一下！**❤️