# kaleido-ai **Repository Path**: javaalpha/kaleido-ai ## Basic Information - **Project Name**: kaleido-ai - **Description**: Kaleido AI是基于微服务架构的AI智能衣柜系统，项目使用JDK21、SpringBoot 3.5、SpringCloud 2025、SpringAI 1.1进行开发，基于DDD + CQRS + 整洁架构，为用户提供衣物管理、个性化穿搭方案和智能推荐服务。 - **Primary Language**: Java - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 13 - **Created**: 2026-02-13 - **Last Updated**: 2026-02-13 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
Kaleido Logo # 🎨 Kaleido AI 智能衣柜 > 基于微服务架构的AI智能衣柜，让每一次穿搭都更懂你 [![JDK](https://img.shields.io/badge/JDK-21-blue)](https://openjdk.org/projects/jdk/21/) [![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.5.6-brightgreen)](https://spring.io/projects/spring-boot) [![Spring Cloud](https://img.shields.io/badge/Spring%20Cloud-2025.0.0-green)](https://spring.io/projects/spring-cloud) [![Spring AI](https://img.shields.io/badge/Spring%20AI-1.1.2-orange)](https://spring.io/projects/spring-ai) [![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) ![Stars](https://img.shields.io/badge/Stars-23-red) [![中文文档](https://img.shields.io/badge/文档-中文-blueviolet)](README.md) [✨ 核心特性](#-核心特性) • [🏗️ 架构设计](#️-架构设计) • [🚀 快速开始](#-快速开始) • [📖 文档](#-文档)
--- ## 📌 项目简介 Kaleido AI 智能衣柜是一个采用 **微服务架构** 的AI智能穿搭管理系统，基于 **DDD领域驱动设计 + CQRS + 整洁架构** 理念构建。 ### 核心功能 - 👑 **后台管理系统** - 完善的用户权限管理（RBAC） - AI Agent 创建与管理 - 工作流编排引擎 - 数据可视化与运营监控 - 📱 **App客户端系统** - **服装管理**：创建服装、管理衣橱、批量导入 - **智能搭配**：AI创建搭配方案、风格推荐 - **个性化配置**：用户信息管理、偏好设置 - **激励体系**：金币机制、用户行为返利、积分兑换 - **智能助手**：AI对话咨询、实时穿搭建议
业务功能
> 💡 **核心价值**：将传统的衣柜管理升级为智能化、个性化的穿搭体验 --- ## ✨ 核心特性 ### 🎯 技术亮点 | 特性 | 说明 | |------|------| | **DDD + CQRS** | 领域驱动设计，读写分离，领域模型独立 | | **整洁架构** | 四层架构（接口层、应用层、领域层、基础设施层），依赖倒置 | | **Spring AI集成** | 无缝对接LLM、向量数据库、RAG能力 | | **微服务架构** | 11个业务服务 + 23个通用模块，独立部署、弹性扩展 | ### 🛠️ 技术栈
业务功能
#### 核心框架 - **Java 21**（LTS版本，虚拟线程支持） - **Spring Boot 3.5.6** + **Spring Cloud 2025.0.0** - **Spring AI 1.1.2**（AI集成框架） - **Spring Cloud Alibaba 2025.0.0.0** #### 微服务生态 - **Nacos 2.3**：服务注册 + 配置中心 - **Sentinel 1.8.7**：流量控制 + 降级熔断 - **Dubbo 3.3.0**：高性能RPC框架 - **Seata 1.8.0**：分布式事务（AT模式） - **XXL-Job 3.3.2**：分布式任务调度 #### 数据存储 - **MySQL 8.4.0**：关系型数据，ShardingSphere分库分表 - **MongoDB 7.0+**：文档型数据，灵活Schema - **Milvus 2.4+**：向量数据库，AI特征存储和相似度搜索 - **Redis 6+**：缓存，JetCache多级缓存（Caffeine + Redis） - **MinIO 8.6.0**：对象存储，图片、文件管理 #### 中间件 - **RabbitMQ 3.13+**：消息队列，异步解耦 - **Redisson 3.52.0**：Redis客户端，分布式锁 - **JetCache 2.7.8**：多级缓存框架 #### 工具库 - **Sa-Token 1.44.0**：轻量级权限认证 - **MyBatis-Plus 3.5.9**：ORM框架 - **MapStruct 1.6.3**：类型安全的对象映射 - **Smart-Doc 2.7.7**：零侵入API文档生成 - **Dynamic-TP 1.2.2-x**：动态线程池监控 #### 完整技术清单
📋 点击展开完整技术版本清单 | 技术 | 版本 | 说明 | |------|------|------| | Java | 21 | 开发语言 | | Spring Boot | 3.5.6 | 应用框架 | | Spring Cloud | 2025.0.0 | 微服务框架 | | Spring Cloud Alibaba | 2025.0.0.0 | 阿里云微服务组件 | | Spring AI | 1.1.2 | AI集成框架 | | MyBatis-Plus | 3.5.9 | ORM框架 | | MySQL | 8.4.0 | 关系型数据库 | | MongoDB | 7.0+ | 文档数据库，用于非结构化数据存储 | | Milvus | 2.4+ | 向量数据库，用于AI特征存储和相似度搜索 | | MinIO | 8.6.0 | 对象存储 | | shardingsphere-jdbc | 5.5.2 | 分库分表 | | Redis | 6+ | 缓存 | | Redisson | 3.52.0 | Redis客户端 | | JetCache | 2.7.8 | 多级缓存框架 | | Caffeine | 3.2.3 | 本地缓存 | | Sa-Token | 1.44.0 | 权限认证框架 | | Sentinel | 1.8.7 | 流量控制和服务降级 | | Dubbo | 3.3.0 | RPC框架 | | Nacos | 2.3.0 | 服务注册与配置中心 | | Seata | 1.8.0 | 分布式事务解决方案 | | XXL-Job | 3.3.2 | 分布式任务调度 | | RabbitMQ | 3.13+ | 消息中间件，用于异步通信和解耦系统 | | Spring AMQP | 3.1.8 | RabbitMQ集成框架 | | Smart-doc | 2.7.7 | API文档生成 | | MapStruct | 1.6.3 | 对象映射工具 | | Lombok | 1.18.36 | 代码简化工具 | | Hutool | 5.8.38 | Java工具库 | | PageHelper | 2.1.1 | MyBatis分页插件 | | Dynamic-tp | 1.2.2-x | 动态线程池 |
--- ## 🏗️ 架构设计 ### 系统架构
系统架构
### 业务架构
业务架构
### 代码分层设计
代码分层设计
目录结构
--- ## 📁 项目结构 ``` kaleido-server/ ├── kaleido-common/ # 公共模块 │ ├── kaleido-aop/ # AOP切面 │ ├── kaleido-api/ # API接口定义 │ ├── kaleido-base/ # 基础工具类 │ ├── kaleido-cache/ # 缓存模块 │ ├── kaleido-distribute/ # 分布式相关 │ ├── kaleido-doc/ # 文档生成 │ ├── kaleido-ds/ # 数据源 │ ├── kaleido-dynamic-tp/ # 动态线程池 │ ├── kaleido-file/ # 文件服务 │ ├── kaleido-job/ # 任务调度 │ ├── kaleido-limiter/ # 限流器 │ ├── kaleido-lock/ # 分布式锁 │ ├── kaleido-mq/ # 消息队列 │ ├── kaleido-nacos/ # 配置中心 │ ├── kaleido-rpc/ # RPC相关 │ ├── kaleido-sa-token/ # 权限认证 │ ├── kaleido-seata/ # 分布式事务 │ ├── kaleido-sentinel/ # 限流降级 │ ├── kaleido-sms/ # 短信服务 │ └── kaleido-web/ # Web相关配置 │ ├── kaleido-gateway/ # API网关 ├── kaleido-auth/ # 认证授权服务 ├── kaleido-biz/ # 业务服务集合 │ ├── kaleido-user/ # 用户服务 │ ├── kaleido-wardrobe/ # 衣柜服务 │ ├── kaleido-ai/ # AI服务 │ ├── kaleido-recommend/ # 推荐服务 │ ├── kaleido-tag/ # 标签服务 │ ├── kaleido-coin/ # 金币服务 │ └── kaleido-mcp/ # MCP服务 ├── kaleido-notice/ # 通知服务 ├── kaleido-admin/ # 管理后台服务 ├── doc/ # 项目文档 ├── scripts/ # 脚本文件 ├── .gitignore # Git忽略配置 ├── pom.xml # 父POM文件 └── README.md # 项目说明文档 ``` --- ## 🚀 快速开始 ### 环境要求 在开始之前，请确保您的开发环境满足以下要求： | 组件 | 版本要求 | 说明 | |----------|------|-----------| | JDK | 21+ | Java开发工具包 | | Maven | 3.8+ | 项目构建工具 | | MySQL | 8.0+ | 关系型数据库 | | MongoDB | 7.0+ | 文档数据库 | | Redis | 6+ | 缓存数据库 | | RabbitMQ | 4.2+ | 消息队列 | | Milvus | 2.4+ | 向量数据库 | | XXL-job | 3.0+ | 计划任务 | ### 部署步骤 #### 1️⃣ 克隆项目 ```bash git clone https://github.com/your-org/kaleido-server.git cd kaleido-server ``` #### 2️⃣ 部署基础设施 部署文件参考 `doc/deploy` 目录。 需要启动的服务包括： - **Nacos**：服务注册与配置中心 - **Sentinel**：流量控制与降级熔断 - **Seata**：分布式事务协调 - **MySQL**：主数据库 - **MongoDB**：文档数据库 - **Redis**：缓存数据库 - **RabbitMQ**：消息队列 - **MinIO**：对象存储 - **Milvus**：向量数据库 - **XXL-job**：分布式任务调度 #### 3️⃣ 配置环境变量 修改文件 `doc/deploy/init_env.bat`，将环境变量替换成你自己的配置，然后执行。 #### 4️⃣ 初始化数据库 依次执行 `doc/sql` 目录中的SQL脚本。 #### 5️⃣ 导入Nacos配置 将 `doc/nacos` 目录中的配置文件导入到Nacos中。 > ⚠️ **注意**：Nacos配置文件使用了大量环境变量，请确保已经配置好环境变量。 ### 构建与启动服务 #### 1️⃣ 编译项目 ```bash # 在项目根目录执行 mvn clean compile -DskipTests ``` #### 2️⃣ 启动核心服务 ```bash # 启动网关服务 cd kaleido-gateway mvn spring-boot:run # 启动认证服务 cd ../kaleido-auth mvn spring-boot:run ``` #### 3️⃣ 启动业务服务 根据需要启动相应的业务服务： ```bash # 用户服务 cd kaleido-biz/kaleido-user mvn spring-boot:run # 衣柜服务 cd ../kaleido-wardrobe mvn spring-boot:run # AI服务 cd ../kaleido-ai mvn spring-boot:run # 推荐服务 cd ../kaleido-recommend mvn spring-boot:run # 其他服务... ``` ### 🔧 验证部署 #### 1️⃣ 访问Nacos控制台 - 地址：http://localhost:8848/nacos - 默认账号：nacos - 默认密码：nacos - 确认所有服务已成功注册 #### 2️⃣ 访问API文档 ```bash # 生成文档 mvn compile smart-doc:html # 文档位置：doc/api/{服务名}/index.html ``` --- ## 📋 开发计划 ### 近期规划 - [ ] 集成ELK可视化日志管理 - [ ] 部署Grafana + Prometheus监控体系 - [ ] 接入SkyWalking链路追踪 - [ ] 前端页面开发 ### 长期规划 - [ ] 多端适配（小程序、App） - [ ] 社区穿搭分享功能 - [ ] 智能购物推荐 - [ ] AR虚拟试衣 --- ## 📖 文档 - [API文档](doc/api/) - [部署文档](doc/deploy/) - [数据库设计](doc/sql/) --- ## 📞 联系作者 微信名片 > 💬 有问题欢迎提Issue或者加我微信联系，我会尽可能解决 😺 --- ## 📄 License 本项目采用 [MIT License](LICENSE) 开源协议。 ---
如果这个项目对你有帮助，请给一个 ⭐️ Star 支持一下！