# molan-cloud

**Repository Path**: pangui0/molan-cloud

## Basic Information

- **Project Name**: molan-cloud
- **Description**: 一套代码，本地单体开发、服务器微服务部署，基于 Spring Boot 3.5 + Spring AI 1.1 + MyBatis-Plus 3.5，完善的 RBAC 权限管理，集成 AI Agent（Tool Calling，SSE 流式输出，工具级权限控制）和 RAG知识库（向量//混合检索+重排序）
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: molandev
- **Homepage**: https://molandev.com
- **GVP Project**: No

## Statistics

- **Stars**: 209
- **Forks**: 91
- **Created**: 2018-11-13
- **Last Updated**: 2026-06-01

## Categories & Tags

**Categories**: backend

**Tags**: None

## README

<div align="center">

<img src="https://molandev.com/logo.svg" alt="Molan" width="120" />

# Molan

**一套代码，本地单体开发，服务器微服务部署**

[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![Java](https://img.shields.io/badge/Java-21-orange.svg)](https://openjdk.org/)
[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.5.11-6DB33F.svg)](https://spring.io/projects/spring-boot)
[![Spring AI](https://img.shields.io/badge/Spring%20AI-1.1.4-6DB33F.svg)](https://spring.io/projects/spring-ai)

**[molandev.com](https://molandev.com)** | [在线预览](https://preview.molandev.com) 账号 `nick` / `123456`

</div>

---

Molan 是一套开源的企业级后台管理解决方案——同一套业务代码，本地以单体模式开发调试，服务器以微服务模式部署上线。集成 AI Agent 与 RAG 知识库，开箱即用。

> 传统方案要么微服务过度设计、2-3 人维护 10+ 服务，要么单体耦合后期推倒重来。Molan 让你本地跑一个进程调试，服务器按服务拆分部署，业务代码不用改。

## ✨ 核心亮点

- 🔄 **双模驱动** — 本地单体开发，服务器微服务部署，同一套业务代码，框架自动路由本地/远程调用
- 🤖 **AI Agent** — 基于 Spring AI Tool Calling，6 类 17 个业务工具，SSE 流式输出 + 工具级权限控制
- 🧠 **RAG 知识库** — 向量检索 / 混合检索 + RRF 融合 + 重排序 + 上下文补全，三级模式按需选择
- 🔐 **全链路安全** — RSA+AES 混合加密、接口防篡改、数据库透明加解密、智能脱敏、网关统一认证

## 🚀 快速开始

> 环境要求：JDK 21+、MySQL 8.0+ 或 PostgreSQL 14+、Redis 6.0+

```bash
git clone https://gitee.com/pangui0/molan-cloud.git
```

详细的初始化数据库、启动后端/前端、微服务部署等步骤，请查看 👉 [molandev.com](https://molandev.com/cloud/getting-started/quick-start.html)

## 🏗️ 项目目录

```
molan-cloud/
├── backend/     # 后端服务（Spring Boot + Spring Cloud + Spring AI）
├── frontend/    # 前端应用（Vue 3 + Element Plus + Vite）
├── framework/   # 双模驱动框架（已发布 Maven Central）
├── converter/   # 文档转换服务（docx/pdf 转 Markdown，已发布 Docker Hub）
├── wiki/        # VitePress 文档站源码
└── scripts/     # 部署脚本与测试数据
```

## 🛠️ 技术栈

| | 技术 |
|---|---|
| 后端 | Java 21 · Spring Boot 3.5 · Spring Cloud 2025 · Spring AI 1.1 · MyBatis-Plus 3.5 |
| 数据库 | MySQL / PostgreSQL · Redis (Redisson) |
| 向量 / 检索 | PgVector / Milvus · Elasticsearch |
| 中间件 | RabbitMQ · Nacos · MinIO |
| 前端 | Vue 3 · Element Plus · Vite |

## 📸 预览

![home](wiki/images/home.png)
![knowledge](wiki/images/knowledge.webp)
![xiuxian](wiki/images/xiuxian.webp)

**在线体验** 👉 [preview.molandev.com](https://preview.molandev.com) 账号 `nick` / `123456`

## 📚 文档 & 协议

| 文档 | 链接 |
|------|------|
| 框架文档 | [molandev.com/framework](https://molandev.com/framework/guide/introduction.html) |
| 应用文档 | [molandev.com/cloud](https://molandev.com/cloud/getting-started/quick-start.html) |
| AI 集成 | [molandev.com/ai](https://molandev.com/ai/xiuxian/introduction.html) |
| 知识库 | [molandev.com/knowledge](https://molandev.com/knowledge/rag/overview.html) |
| 部署指南 | [molandev.com/cloud](https://molandev.com/cloud/getting-started/deployment.html) |
| 文档转换 | [molandev.com/converter](https://molandev.com/converter/overview.html) |

[MIT License](https://opensource.org/licenses/MIT) — 自由使用，无任何限制