# QuickStack - 前后端分离项目初始化工具

[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

> 🚀 **QuickStack** - 一款强大的全栈项目初始化工具，让你在几秒钟内搭建好前后端分离的开发环境。

## ✨ 功能特性

- **多种前端框架支持**: React, Vue
- **丰富的后端选择**: Go(标准库/Gin), Python(Flask/FastAPI/Django), Java(Spring Boot), JavaScript(Express.js/NestJS)
- **集成 Tailwind CSS**: 一键配置现代化的 CSS 框架
- **自动生成启动脚本**: Windows BAT 脚本，双击即可启动项目
- **跨域配置**: 所有后端模板均已配置 CORS，前后端联调无障碍
- **交互式 CLI**: 友好的命令行交互界面

## 📦 支持的技术栈

### 前端框架
- ⚛️ React (Vite + React)
- 💚 Vue (Vite + Vue)

### 后端框架
- 🐹 Go (标准库 http)
- 🚀 Go (Gin 框架)
- 🐍 Python (Flask)
- ⚡ Python (FastAPI)
- 🎯 Python (Django)
- ☕ Java (Spring Boot)
- 🟨 JavaScript (Express.js)
- 🐈‍⬛ JavaScript (NestJS)

## 🔧 环境要求

- Python 3.8+
- Node.js 16+ (前端项目和 JS 后端需要)
- Go 1.18+ (Go 后端需要)
- Java 17+ 和 Maven 3.6+ (Spring Boot 后端需要)

## 🚀 使用方法

### 1. 克隆项目

```bash
git clone <your-repo-url>
cd QuickStack
```

### 2. 运行初始化脚本

```bash
python main.py
```

### 3. 按照提示操作

- 输入项目名称（英文）
- 选择前端框架（React/Vue）
- 选择是否使用 Tailwind CSS
- 选择后端框架

### 4. 启动项目

进入生成的项目目录，双击运行：

- `开启前端.bat` - 启动前端开发服务器
- `开启后端.bat` - 启动后端服务
- `构建前端.bat` - 构建前端生产版本

## 📁 项目结构

```
QuickStack/
├── main.py              # 主程序入口
├── utils.py             # 工具函数
├── directory.py         # 目录管理
├── scripts.py           # 启动脚本生成
├── frontend/            # 前端模块
│   ├── react.py         # React 初始化
│   ├── vue.py           # Vue 初始化
│   └── tailwind.py      # Tailwind CSS 配置
├── backend/             # 后端模块
│   ├── golang.py        # Go 初始化
│   ├── python_flask.py  # Flask 初始化
│   ├── python_fastapi.py# FastAPI 初始化
│   ├── python_django.py # Django 初始化
│   ├── java_spring.py   # Spring Boot 初始化
│   ├── js_express.py    # Express.js 初始化
│   └── js_nestjs.py     # NestJS 初始化
└── README.md            # 项目说明
```

## 🎯 生成的项目示例

```
myproject/
├── myproject-frontend/     # 前端项目
│   ├── src/
│   ├── package.json
│   └── ...
├── myproject-backend/      # 后端项目
│   ├── src/ 或 main.go 等
│   └── ...
├── 开启前端.bat            # 启动前端
├── 开启后端.bat            # 启动后端
└── 构建前端.bat            # 构建前端
```

## 🔌 API 端点

所有后端模板都包含健康检查端点：

```
GET http://localhost:8080/api/health
```

响应示例：
```json
{
  "status": "ok",
  "message": "Welcome to myproject API"
}
```

## ⚙️ 自定义配置

### Tailwind CSS

如果选择使用 Tailwind CSS，会自动：
- 安装 tailwindcss、postcss、autoprefixer
- 初始化配置文件
- 更新 CSS 文件
- 创建示例组件

### CORS 跨域

所有后端模板均已配置 CORS，允许：
- 来源: `*` (所有域名)
- 方法: GET, POST, PUT, DELETE, OPTIONS
- 请求头: Content-Type, Authorization 等

## 📝 注意事项

1. **Windows 专用**: 本项目生成的启动脚本是 `.bat` 格式，专用于 Windows 系统
2. **Python 虚拟环境**: Python 后端会自动创建虚拟环境并安装依赖
3. **npm 依赖**: 前端项目会自动安装 npm 依赖
4. **端口**: 后端服务默认运行在 8080 端口

## 🐛 常见问题

### Q: 前端项目创建失败？
A: 请确保已安装 Node.js (16+) 和 npm，并检查网络连接。

### Q: Python 后端依赖安装失败？
A: 请确保 Python 环境正常，并检查 pip 是否可用。可以手动进入目录运行 `pip install -r requirements.txt`。

### Q: 如何修改默认端口？
A: 修改后端项目的配置文件或代码中的端口设置即可。

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📄 许可证

MIT License

## 💖 致谢

感谢使用 QuickStack！祝开发愉快！

---

**QuickStack** - 让全栈开发更简单 🚀