项目架构

欢迎了解 Astrsomn 项目的架构设计！本章节将帮助您理解项目的整体结构和设计理念。

架构概览

Astrsomn 是一个基于 Spring Boot 的 AI 应用框架，提供大模型集成、智能体管理、工作流编排等核心能力。

核心设计理念

1. 模块化设计：采用模块化架构，各模块职责清晰，便于扩展和维护
2. 插件化扩展：通过 SPI 机制实现模型供应商、向量库、MCP 的可插拔扩展
3. 声明式编程：使用 @Astro 注解实现智能体的自动注入和管理
4. 松耦合：通过 API 接口层实现模块间的解耦

模块结构

Astrsomn/
├── astrsomn-common                    # 通用基础模块
├── astrsomn-api                       # API 接口定义层
│   ├── astrsomn-api-runtime           # 运行时 API
│   ├── astrsomn-api-storage           # 存储 API
│   └── astrsomn-api-workflow          # 工作流 API（规划中）
├── astrsomn-integrations              # 集成层（Spring Boot Starter）
│   ├── astrsomn-runtime-starter       # 运行时 Starter
│   ├── astrsomn-workflow-starter      # 工作流 Starter（规划中）
│   └── astrsomn-internal-storage      # 内部存储实现
├── astrsomn-plugins                   # 插件生态
│   ├── astrsomn-providers             # 模型提供方实现
│   └── astrsomn-vector                # 向量存储实现
└── astrsomn-server                    # 服务端应用

技术栈

层	技术	版本
语言	Java	17+
框架	Spring Boot	3.3.0
AI 框架	LangChain4j	1.11.x
ORM	MyBatis-Plus	3.5.x
数据库	MySQL	8.0+
构建工具	Maven	3.8+

目录结构

docs/zh/project-architecture/
├── 概述（本页）
├── 整体架构
├── 模块结构
└── 项目概述

下一步

• 整体架构 - 深入了解系统架构设计
• 模块结构 - 详细了解各模块职责
• 项目概述 - 了解项目整体情况
• 框架使用 - 了解如何使用框架