144 lines
3.6 KiB
Markdown
144 lines
3.6 KiB
Markdown
# 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)
|
||
|
||
## 联系方式
|
||
|
||
- 项目负责人: 亮哥（初如）
|