yudao-asset-cloud/README.md

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. 启动基础环境

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

# 查看服务状态
docker-compose ps

2. 初始化数据库

# 导入 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. 启动后端服务

# 方式一：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

# 上传项目到服务器
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

项目进度

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

文档

• YuDao Cloud 官方文档
• 项目需求文档

联系方式

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