# ones_Spring_Cloud

**Repository Path**: linly-language/ones_-spring_-cloud

## Basic Information

- **Project Name**: ones_Spring_Cloud
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-10-30
- **Last Updated**: 2026-04-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Ones Spring Cloud - 项目管理系统

## 项目简介

Ones Spring Cloud 是一款基于 Spring Cloud 分布式架构的智能化项目管理平台，结合 Vue 3 前端框架与 AI 技术，实现轻量级项目管理流程。通过 AI 智能体，帮助团队更智能便捷地完成项目-需求-任务-缺陷的工作流程管理。

## 核心功能

| 模块 | 功能描述 |
|------|---------|
| **项目管理** | 项目创建、成员管理、版本控制、模块管理 |
| **需求管理** | 需求跟踪、状态管理、优先级设置 |
| **任务管理** | 任务分配、进度跟踪、工时记录 |
| **缺陷管理** | 缺陷跟踪、分级处理、进度统计 |
| **工作项管理** | 迭代管理、工作项关联、进度追踪 |
| **团队管理** | 团队创建、成员管理、项目分配 |
| **文档管理** | 文档编辑、分类管理、收藏功能 |
| **测试管理** | 测试计划、用例管理 |
| **消息通知** | 任务申请、审批流程、消息推送 |
| **进度报表** | 燃尽图、甘特图、统计报表 |
| **AI 智能体** | 自然语言交互、智能任务创建 |

## 技术架构

### 后端技术栈

- **核心框架**: Spring Boot 3.x + Spring Cloud 2023.0.3
- **服务治理**: Nacos（注册/配置）、OpenFeign（远程调用）、Seata（分布式事务）
- **安全认证**: Spring Security 6.x + JWT
- **数据存储**: MySQL 8.0 + Redis 8.0（支持 Redis Stack 向量数据库）
- **AI 集成**: Spring AI 1.x + Spring AI Alibaba（Qwen 大模型）
- **缓存中间件**: Redisson 分布式锁

### 前端技术栈

- **框架**: Vue 3（Composition API）
- **构建工具**: Vite 5.x
- **UI 组件**: Element Plus
- **HTTP 客户端**: Axios
- **图表库**: ECharts

### AI 模块架构

```
ai-server/
├── supervisor-agent/     # 主智能体（路由协调）
├── project-sub-agent/    # 项目管理子智能体
├── task-sub-agent/       # 任务管理子智能体
├── consult-sub-agent/    # 咨询问答子智能体
├── project-mcp-server/   # 项目管理 MCP 服务
├── task-mcp-server/      # 任务管理 MCP 服务
├── memory-mcp-server/    # 记忆管理 MCP 服务
```

## 项目结构

```
ones-spring-cloud/
├── business/                    # 业务服务层
│   ├── admin-ai-server/        # AI 管理员服务
│   ├── ai-server/              # AI 核心服务
│   ├── project-server/         # 项目管理服务
│   ├── task-server/            # 任务管理服务
│   ├── requirement-service/    # 需求管理服务
│   ├── defect-server/          # 缺陷管理服务
│   ├── workItem-server/        # 工作项管理服务
│   ├── team-server/            # 团队管理服务
│   ├── doc-server/             # 文档管理服务
│   ├── test-server/            # 测试管理服务
│   ├── notifications-server/   # 消息通知服务
│   └── progress-server/        # 进度报表服务
├── cloud-iaaS/                 # 基础设施层
│   ├── auth-server/            # 认证授权服务
│   ├── gateway/                # API 网关
│   └── log-server/             # 日志服务
├── common/                      # 公共模块
│   ├── pojo/                   # 实体/DTO/VO
│   ├── utils/                  # 工具类
│   └── config/                 # 公共配置
└── frontend/                   # Vue 3 前端项目
```

## 环境要求

| 组件 | 版本要求 | 说明 |
|-----|---------|-----|
| JDK | 17+ | 必须使用 JDK 17 或更高版本 |
| Node.js | 22.x | 必须使用 Node.js 22 或更高版本 |
| MySQL | 8.0+ | 推荐 8.0+ 版本 |
| Redis | 8.0+ | 8.0以下版本需使用 Redis Stack |
| Maven | 3.6+ | 后端构建工具 |

## 快速开始

### 1. 后端部署

```bash
# 克隆项目
git clone https://gitee.com/linly-language/ones_-spring_-cloud.git
cd ones-spring-cloud

# 编译项目
mvn clean package -DskipTests

# 启动服务（按顺序）
java -jar cloud-iaaS/auth-server/target/auth-server.jar
java -jar cloud-iaaS/gateway/target/gateway.jar
java -jar business/project-server/target/project-server.jar
# ... 启动其他业务服务
```

### 2. 前端部署

```bash
# 进入前端目录
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 生产环境构建
npm run build
```

### 3. Docker 部署（可选）

```bash
# 启动基础服务
docker-compose up -d mysql redis nacos

# 构建并启动所有服务
./build.sh
```

## 配置说明

### 核心配置

```yaml
# application.yml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/ones_project
    username: root
    password: your_password
  redis:
    host: localhost
    port: 6379
    password: your_redis_password

# Nacos 配置
spring.cloud.nacos.config.server-addr: localhost:8848
spring.cloud.nacos.discovery.server-addr: localhost:8848
```

## API 文档

服务启动后，可通过以下地址访问：

| 服务 | 地址 | 说明 |
|-----|-----|-----|
| API 网关 | http://localhost/ | 统一 API 入口 |
| Nacos 控制台 | http://localhost:8080/nacos | 配置管理 |
| Swagger 文档 | http://localhost:端口/swagger-ui.html | 接口文档 |

## 开发规范

### 分层架构

```
Controller     ->  请求接收与响应
Service        ->  业务逻辑处理
Mapper/DAO     ->  数据访问层
Entity/DO      ->  数据实体模型
```

### 命名规范

- **类名**: 大驼峰命名，如 `ProjectServiceImpl`
- **方法名**: 小驼峰命名，如 `getProjectList()`
- **表名**: 使用小写下划线，如 `hxx_ones.projects`
- **常量**: 全大写下划线，如 `PROJECT_CACHE_KEY`

### 代码提交

```bash
# 提交信息格式
<type>(<scope>): <subject>

# 示例
feat(project): 添加项目成员管理功能
fix(task): 修复任务状态更新问题
docs(readme): 更新文档说明
```

## 常见问题

### 端口冲突

```bash
# 查看端口占用
lsof -i :8080

# 或使用 netstat
netstat -tunlp | grep 8080
```

### 内存不足

```bash
# 查看内存使用
free -h

# 清理内存缓存
echo 3 > /proc/sys/vm/drop_caches
```

### 启动失败

```bash
# 查看应用日志
tail -f /path/to/app/logs/application.log

# 检查依赖服务
systemctl status mysql
systemctl status redis
```

## 贡献指南

1. Fork 本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

## 许可证

本项目遵循 [Apache License 2.0](LICENSE) 开源协议。

## 联系方式

- **项目地址**: https://gitee.com/linly-language/ones_-spring_-cloud
- **技术邮箱**: 1229866788@qq.com

---

*文档会根据项目更新持续维护，请关注最新版本。*