# 05ai_cli

**Repository Path**: spanky/05ai_cli

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-21
- **Last Updated**: 2026-01-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 05ai_cli

**领悟信息**软件外包公司的项目快速生成脚手架工具，基于 Cool-Admin 框架。

## 简介

05ai_cli 是一个用于快速创建和部署信息系统管理项目的脚手架工具。通过本项目，可以快速生成包含后台管理系统、移动端（H5/小程序）和数据大屏的完整项目。

### 核心特性

- 🚀 **快速生成** - 基于模板快速创建新项目
- 🎨 **低代码开发** - 通过 Cool-Admin 的 CRUD 组件实现零代码增删改查
- 📦 **模块化设计** - 业务模块可插拔，易于维护
- 🔐 **完整的权限系统** - 基于 RBAC 的菜单级/按钮级权限控制
- 🤖 **AI 友好** - 支持通过 AI 进行代码生成
- 📱 **多端支持** - 一套后端支持 PC、H5、小程序、数据大屏

## 技术栈

### 后端
- **Java 17+** (Spring Boot 3.2.5)
- **Mybatis-Flex** - ORM 框架
- **MySQL 8.0+** / PostgreSQL
- **SpringDoc OpenAPI** - API 文档
- **Quartz** - 定时任务
- **Spring Security** - 安全框架

### 前端
- **Vue 3.5** + TypeScript 5.5
- **Vite 5.4** - 构建工具
- **Element Plus 2.10** - UI 组件库
- **Pinia 2.3** - 状态管理
- **ECharts 5.6** - 图表库
- **TailwindCSS 3.4** - CSS 框架

## 快速开始

### 环境要求

- **Java**: 17+
- **Maven**: 3.6+
- **Node.js**: 18+
- **MySQL**: 8.0+

### 安装与启动

```bash
# 1. 克隆项目
git clone <repository-url>
cd 05ai_cli

# 2. 使用统一启动脚本（推荐）
./dev.sh

# 按照菜单提示操作即可
```

启动成功后访问：

| 服务 | 地址 | 账号 |
|------|------|------|
| 前端管理后台 | http://localhost:9000 | admin / 123456 |
| 后端 API | http://localhost:8001 | - |
| Swagger 文档 | http://localhost:8001/swagger | - |

### 手动启动

如需手动启动各个服务：

```bash
# 启动后端
cd code/cool-admin-java
export JAVA_HOME=/opt/homebrew/opt/openjdk@23/libexec/openjdk.jdk/Contents/Home
mvn spring-boot:run

# 启动前端（新开终端）
cd code/cool-admin-vue
npm install      # 首次需要
npm run dev
```

### 停止服务

```bash
./dev.sh stop
```

## 项目结构

```
05ai_cli/
├── code/
│   ├── cool-admin-java/          # 后端 Spring Boot 项目
│   └── cool-admin-vue/           # 前端 Vue3 项目
├── docs/                         # 项目文档
├── scripts/                      # 脚手架工具脚本
├── dev.sh                        # 统一开发启动脚本
├── CLAUDE.md                     # Claude AI 开发指南
└── README.md                     # 本文件
```

## 开发指南

### 前端模块开发

前端采用模块化架构，位于 `code/cool-admin-vue/src/modules/` 或 `src/plugins/`：

```
modules/模块名/
├── components/    # 全局组件
├── directives/    # 全局指令
├── locales/       # 国际化
├── store/         # 状态管理 (Pinia)
├── views/         # 视图路由
├── config.ts      # 模块配置（必须）
└── index.ts       # 模块导出
```

### CRUD 组件使用

Cool-Admin 提供了强大的低代码 CRUD 组件：

```vue
<cl-crud ref="Crud">
  <cl-row>
    <cl-refresh-btn />
    <cl-add-btn />
    <cl-multi-delete-btn />
    <cl-search-key />
  </cl-row>
  <cl-table ref="Table" />
  <cl-upsert ref="Upsert" />
</cl-crud>
```

### Import 路径别名

| 别名 | 对应路径 |
|------|----------|
| `/@` | `./src` |
| `/$` | `./src/modules` |
| `/#` | `./src/plugins` |
| `/~` | `./packages` |

详细开发规范请参考：
- `code/cool-admin-vue/.cursorrules` - 前端开发规范
- `code/cool-admin-vue/.cursor/rules/` - 各组件使用规范

## 常用命令

### 前端

```bash
cd code/cool-admin-vue

npm run dev           # 开发模式
npm run build         # 生产构建
npm run lint          # 代码检查
npm run format        # 代码格式化
```

### 后端

```bash
cd code/cool-admin-java

mvn compile           # 编译项目
mvn spring-boot:run   # 启动后端
mvn clean package -DskipTests  # 构建 JAR 包
```

## 文档

完整文档位于 `docs/` 目录：

- [项目起源和背景](docs/1.项目起源和背景.md) - 项目定位、技术选型过程
- [Cool-Admin 架构详解](docs/2.Cool-Admin架构详解.md) - 技术栈、项目结构、核心特性
- [Docker 部署方案](docs/3.Docker部署方案.md) - Docker 配置和部署步骤
- [项目结构速览](docs/4.项目结构速览.md) - 模块对应关系、开发流程
- [本地开发启动指南](docs/5.①本地开发启动指南.md) - 环境要求、快速启动
- [dev.sh 使用说明](docs/5.②dev.sh使用说明.md) - 脚手架脚本命令参考

## 常见问题

### 端口被占用

```bash
# 查看占用端口
lsof -i :8001    # 后端
lsof -i :9000    # 前端

# 杀死进程
kill -9 <PID>
```

### 数据库连接失败

```bash
# 检查 MySQL 是否运行
brew services list | grep mysql

# 启动 MySQL
brew services start mysql
```

### 查看日志

```bash
# 后端日志
tail -f /tmp/cool-backend.log

# 前端日志
tail -f /tmp/cool-frontend.log
```

## 许可证

本项目基于 Cool-Admin 框架构建，仅供内部使用。