# YuDao Asset Cloud - 资产管理系统

基于 YuDao Cloud 重构的资产管理系统。

## 技术栈

- **后端**: Spring Boot 3.5 + Spring Cloud 2024 + JDK 17
- **数据库**: MySQL 8.0 + Redis 7.0
- **注册中心**: Nacos 2.3
- **工作流**: Flowable
- **定时任务**: XXL-Job 2.4
- **前端**: Vue3 + Vben Admin

## 项目结构

```
yudao-asset-cloud/
├── yudao-dependencies/          # 依赖管理
├── yudao-framework/             # 框架核心
├── yudao-gateway/               # 网关
├── yudao-server/                # 单体启动（开发用）
├── yudao-module-system/         # 系统管理模块
├── yudao-module-infra/          # 基础设施模块
├── yudao-module-bpm/            # 工作流模块
├── yudao-module-asset/          # 资产管理模块 ⭐
│   ├── yudao-module-asset-api/  # API 接口
│   └── yudao-module-asset-biz/  # 业务实现
├── sql/                         # 数据库脚本
└── docker-compose.yml           # Docker 编排
```

## 核心功能

### 第一阶段（已规划）
1. **基础数据**: 车辆、客户、停车场
2. **备车管理**: 车辆整备、检查项配置
3. **合同管理**: 合同创建、审批流
4. **交车管理**: 任务派发、交车作业
5. **还车管理**: 还车作业、费用结算
6. **替换车管理**: 临时/永久替换

## 快速开始

### 1. 启动基础环境

```bash
# 启动 MySQL + Redis + Nacos + XXL-Job
docker-compose up -d

# 查看服务状态
docker-compose ps
```

### 2. 初始化数据库

```bash
# 导入 YuDao 基础表
mysql -h127.0.0.1 -uroot -p123456 ruoyi-vue-pro < sql/mysql/ruoyi-vue-pro.sql

# 导入资产管理表
mysql -h127.0.0.1 -uroot -p123456 ruoyi-vue-pro < sql/asset-schema.sql
```

### 3. 启动后端服务

```bash
# 方式一：IDEA 启动（推荐开发）
# 运行 AssetServerApplication.java

# 方式二：Maven 启动
cd yudao-module-asset/yudao-module-asset-biz
mvn spring-boot:run
```

### 4. 访问地址

- **Nacos 控制台**: http://localhost:8848/nacos (nacos/nacos)
- **XXL-Job 控制台**: http://localhost:9090/xxl-job-admin (admin/123456)
- **后端 API**: http://localhost:48083
- **测试接口**: http://localhost:48083/admin-api/asset/truck/test

## 开发规范

### 数据库表命名
- 统一前缀: `asset_`
- 示例: `asset_truck`, `asset_contract`

### 包结构
```
cn.iocoder.yudao.module.asset/
├── controller/admin/            # 管理后台控制器
├── controller/app/              # 移动端控制器（可选）
├── service/                     # 服务层
├── dal/
│   ├── dataobject/             # DO 实体
│   ├── mysql/                  # Mapper
│   └── redis/                  # Redis 操作
├── convert/                     # 对象转换
└── enums/                       # 枚举
```

### 代码生成
使用 YuDao 代码生成器快速生成 CRUD 代码。

## 部署

### 开发环境
- **服务器**: 47.103.115.36 (Ubuntu 24.04)
- **部署方式**: Docker Compose

```bash
# 上传项目到服务器
scp -r yudao-asset-cloud root@47.103.115.36:/opt/

# SSH 登录服务器
ssh root@47.103.115.36

# 启动服务
cd /opt/yudao-asset-cloud
docker-compose up -d
```

## 项目进度

- [x] 项目初始化
- [x] 模块结构搭建
- [x] 数据库设计
- [x] Docker 环境配置
- [ ] 车辆管理 CRUD
- [ ] 备车功能
- [ ] 合同管理
- [ ] 交车功能
- [ ] 还车功能
- [ ] 替换车功能

## 文档

- [YuDao Cloud 官方文档](https://cloud.iocoder.cn)
- [项目需求文档](../memory/2026-03-11-资产管理系统重构.md)

## 联系方式

- 项目负责人: 亮哥（初如）
