# Singularity **Repository Path**: singularitys_0/singularity ## Basic Information - **Project Name**: Singularity - **Description**: No description available - **Primary Language**: Shell - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-05-20 - **Last Updated**: 2026-06-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Singularity 车辆管理系统

Spring Boot Vue TypeScript Java License

## 项目简介 Singularity 是一套面向物流运输行业的**全栈车辆管理系统**，采用微服务架构设计，涵盖 Web 管理后台、移动端应用、智能管车等功能模块。系统基于规范驱动开发（Specification-Driven Development）理念构建，采用 Agent Teams 框架实现自动化代码生成。 ### 系统架构 ``` ┌─────────────────────────────────────────────────────────────────┐ │ 客户端层 │ ├─────────────────┬─────────────────────┬────────────────────────┤ │ Web 管理后台 │ 移动端 App │ 微信小程序 │ │ (Singularity- │ (Singularity-App) │ (Uni-app 多端) │ │ Vue) │ │ │ └────────┬────────┴──────────┬─────────┴───────────┬────────────┘ │ │ │ ▼ ▼ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ API 网关层 (Singularity-Cloud) │ │ (RuoYi-based) │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 应用服务层 (Singularity-Boot) │ ├─────────────────────────────────────────────────────────────────┤ │ Controller → Service → Mapper (MyBatis-Plus) │ │ 安全认证 | 业务逻辑 | 数据访问 │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 数据存储层 │ ├─────────────┬─────────────┬─────────────┬────────────────────┤ │ MySQL │ Redis │ MinIO │ XXL-JOB │ │ (主数据库) │ (缓存/会话) │ (对象存储) │ (任务调度) │ └─────────────┴─────────────┴─────────────┴────────────────────┘ ``` ### 功能模块 | 模块 | 编码 | 描述 | |-------|-----------|-------------| | 车辆档案 | VE-BAS | 车辆基本信息、状态管理 | | 司机档案 | DRV | 司机信息、资质管理 | | 供应商档案 | SUP | 承运商、供应商管理 | | 线路档案 | ROU | 运输线路管理 | | 电子围栏 | FEN | 区域管理 | | 营收管理 | FIN-REV | 收入与应收管理 | | 应付管理 | FIN-PAY | 支出与应付管理 | | 预算管理 | FIN-BUD | 预算编制与控制 | | 成本规则 | RULE-COST | 成本计算规则 | | GPS集成 | INT-GPS | 定位设备集成 | --- ## 技术栈 ### 后端技术 | 技术 | 版本 | 说明 | |-----------------|--------|----------| | Java | 17 | 编程语言 | | Spring Boot | 3.5.6 | 核心框架 | | Spring Security | 6.x | 安全认证 | | MyBatis-Plus | 3.5.8 | ORM 框架 | | MySQL | 8.x | 主数据库 | | Druid | 1.2.24 | 连接池 | | Redis | - | 分布式缓存 | | Caffeine | 2.9.3 | 本地缓存 | | JWT | - | Token 认证 | | Knife4j | 4.5.0 | API 文档 | | XXL-JOB | 3.3.0 | 任务调度 | | MinIO | 8.6.0 | 对象存储 | | Redisson | 3.51.0 | 分布式锁 | | EasyExcel | 4.0.3 | Excel 处理 | | Hutool | 5.8.41 | 工具库 | | MapStruct | 1.6.3 | 对象映射 | ### 前端技术 | 技术 | 版本 | 说明 | |--------------|-------|----------| | Vue | 3.5.x | 核心框架 | | Vite | - | 构建工具 | | TypeScript | 5.x | 类型系统 | | Element-Plus | 2.x | UI 组件库 | | Pinia | - | 状态管理 | | Axios | - | HTTP 客户端 | | Vue Router | 4.x | 路由管理 | ### 移动端技术 | 技术 | 说明 | |---------|--------| | Uni-app | 跨端应用框架 | | Vue 3 | 核心框架 | | uni-ui | 移动端组件库 | --- ## 项目结构 ``` Singularity/ ├── Singularity-Boot/ # Spring Boot 后端 │ ├── src/ │ │ ├── main/ │ │ │ ├── java/com/singularity/boot/ │ │ │ │ ├── controller/ # 控制器层 │ │ │ │ ├── service/ # 业务逻辑层 │ │ │ │ ├── mapper/ # 数据访问层 │ │ │ │ ├── entity/ # 实体类 │ │ │ │ ├── vo/ # 视图对象 │ │ │ │ ├── form/ # 表单对象 │ │ │ │ ├── query/ # 查询对象 │ │ │ │ ├── security/ # 安全认证 │ │ │ │ └── config/ # 配置类 │ │ │ └── resources/ │ │ │ ├── mapper/ # MyBatis XML │ │ │ ├── templates/ # 代码生成模板 │ │ │ └── application.yml │ │ └── test/ # 测试代码 │ ├── docker/ # Docker 配置 │ └── pom.xml │ ├── Singularity-Vue/ # Vue3 管理后台 │ ├── src/ │ │ ├── api/ # API 接口 │ │ ├── components/ # 公共组件 │ │ ├── composables/ # 组合式 API │ │ ├── layouts/ # 布局组件 │ │ ├── router/ # 路由配置 │ │ ├── store/ # 状态管理 │ │ ├── views/ # 页面组件 │ │ ├── utils/ # 工具函数 │ │ └── types/ # TypeScript 类型 │ ├── mock/ # Mock 数据 │ ├── public/ # 静态资源 │ └── package.json │ ├── Singularity-App/ # Uni-app 移动端 │ ├── src/ │ │ ├── components/ # 组件 │ │ ├── pages/ # 页面 │ │ ├── static/ # 静态资源 │ │ ├── store/ # 状态管理 │ │ ├── utils/ # 工具函数 │ │ └── App.vue │ ├── pages.json # 页面配置 │ └── package.json │ ├── Singularity-Cloud/ # 微服务网关 │ ├── Singularity-Document/ # 项目文档 │ ├── 00_总体需求规划/ # 需求规划 │ ├── 01_模块需求文档/ # PRD 文档 │ ├── 03_接口逻辑/ # 接口设计 │ ├── 04_字典/ # 数据字典 │ ├── 06_任务清单/ # 开发记录 │ ├── 07_参考资料/ # 参考资料 │ └── 12_架构师文档/ # 架构规范 │ ├── .trae/ # Agent Teams 配置 │ ├── teams/ # 团队配置 │ ├── skills/ # 代码生成技能 │ └── 要求/ # 规范文档 │ └── README.md # 项目说明文档 ``` --- ## 快速开始 ### 环境要求 | 环境 | 要求 | |---------|------| | JDK | 17+ | | Node.js | 18+ | | MySQL | 8.0+ | | Redis | 6.0+ | | pnpm | 8.0+ | | Maven | 3.8+ | ### 后端启动 ```bash # 进入后端目录 cd Singularity-Boot # 编译打包 mvn clean package -DskipTests # 启动应用 mvn spring-boot:run # API 文档访问地址 # http://localhost:8080/doc.html ``` ### 管理后台启动 ```bash # 进入前端目录 cd Singularity-Vue # 安装依赖（自动使用 pnpm） pnpm install # 启动开发服务器 pnpm dev # 构建生产版本 pnpm build ``` ### 移动端启动 ```bash # 进入移动端目录 cd Singularity-App # 安装依赖 pnpm install # H5 开发 pnpm dev:h5 # App 开发 pnpm dev:app # 微信小程序 pnpm dev:mp-weixin ``` --- ## 开发指南 ### 代码规范 - **后端**: 遵循阿里巴巴 Java 开发规范 - **前端**: ESLint + Prettier + Stylelint - **提交**: Conventional Commits 规范 ### Git 提交规范 ```bash # 使用交互式提交 pnpm commit # 提交类型 feat: 新功能 fix: Bug 修复 docs: 文档更新 style: 代码格式 refactor: 代码重构 test: 测试相关 chore: 构建/工具 ``` ### API 文档 后端服务启动后，访问 `http://localhost:8080/doc.html` 查看完整的 API 文档。 --- ## Agent Teams 开发框架 本项目采用**规范驱动开发**理念，基于 Agent Teams 框架实现自动化开发。 ### 团队配置 | 团队 ID | 名称 | 描述 | |--------------------|-----------|----------------------| | TEAM-FULLSTACK-001 | 全栈开发 Team | 数据库 → 后端 → 前端 → 代码审查 | ### 开发流程 ``` 需求输入 → 任务识别 → 设计阶段(数据库架构师) → 开发阶段(后端+前端) → 审查阶段 → 交付 ``` ### 代码生成 使用 SKILL 进行代码生成： ```bash # 后端代码生成 singularity-codegen-entity # 实体类 singularity-codegen-vo # 视图对象 singularity-codegen-mapper # Mapper 接口 singularity-codegen-service # Service 接口 singularity-codegen-controller # 控制器 # 前端代码生成 singularity-codegen-api # API 接口 singularity-codegen-view-index # 页面入口 singularity-codegen-view-list # 列表页面 singularity-codegen-view-add # 新增页面 singularity-codegen-view-edit # 编辑页面 ``` --- ## 核心模块开发进度 | 模块 | 状态 | 说明 | |---------------|-----|-----------------| | 车辆档案 (VE-BAS) | 进行中 | Phase 2: 列表查询实现 | | 司机档案 | 已完成 | 一期交付 | | 供应商档案 | 已完成 | 二期交付 | | 线路档案 | 进行中 | 开发中 | | 电子围栏 | 进行中 | 开发中 | --- ## 部署说明 ### Docker 部署 ```bash # 后端 Docker 镜像构建 cd Singularity-Boot docker build -t singularity-boot:latest . # docker-compose 一键部署（推荐） cd Singularity-Boot/docker docker-compose up -d ``` ### 环境配置 | 环境变量 | 说明 | 默认值 | |------------------------|----------|-----------| | SPRING_PROFILES_ACTIVE | 运行环境 | dev | | MYSQL_HOST | MySQL 地址 | localhost | | MYSQL_PORT | MySQL 端口 | 3306 | | REDIS_HOST | Redis 地址 | localhost | | REDIS_PORT | Redis 端口 | 6379 | --- ## [后端架构师规范 相关文档 -](./Singularity-Document/12_架构师文档/角色规范/角色规范_后端架构师-Singularity.md) - [前端架构师规范](./Singularity-Document/12_架构师文档/角色规范/角色规范_前端架构师-Singularity.md) - [数据库架构师规范](./Singularity-Document/12_架构师文档/角色规范/角色规范_数据库架构师-Singularity.md) - [需求文档格式标准](./Singularity-Document/00_总体需求规划/文档格式/需求文档格式标准.md) - [代码规范](./.trae/rules/代码规范.md) --- ## 许可证 MIT License --- ## 联系方式 - 项目维护者: Singularity Team - 最后更新: 2026-03-04 - 版本: v3.3.0+