# Fengling 项目快速开始指南

## 🚀 5分钟快速启动

### 1. 环境检查

确保已安装以下软件：
- [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0)
- [Node.js 18+](https://nodejs.org/)
- [Docker Desktop](https://www.docker.com/products/docker-desktop/)
- [Git](https://git-scm.com/)

验证安装：
```bash
dotnet --version    # 应显示 10.0.xxx
node --version      # 应显示 18.x 或 20.x
docker --version    # 应显示 Docker 版本
```

### 2. 获取代码

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

### 3. 启动基础设施

```bash
# 启动 Redis 和其他依赖服务
cd Backend/scripts
docker-compose up -d
```

### 4. 启动后端服务

```bash
# 新终端窗口
cd Backend/src/Fengling.Backend.Web
dotnet run
```

后端将在 `http://localhost:5511` 启动

### 5. 启动前端

```bash
# 管理后台 - 新终端窗口
cd Frontend/Fengling.Backend.Admin
pnpm install
pnpm dev

# H5会员端 - 新终端窗口  
cd Frontend/Fengling.H5
pnpm install
pnpm dev
```

### 6. 访问应用

- **管理后台**: http://localhost:3000
- **H5会员端**: http://localhost:3001
- **API 文档**: http://localhost:5511/swagger

---

## 📁 项目结构速览

```
Demo/
├── Backend/                 # 后端服务 (.NET 10)
│   ├── src/                # 源代码
│   ├── test/               # 测试代码
│   └── scripts/            # 基础设施脚本
├── Frontend/
│   ├── Fengling.Backend.Admin/  # 管理后台 (Vue 3)
│   └── Fengling.H5/             # H5会员端 (Vue 3)
├── docs/                   # 详细文档
└── PROJECT_DOCUMENTATION.md     # 完整文档
```

---

## 🔧 常用命令

### 后端开发
```bash
# 还原依赖
dotnet restore

# 构建项目
dotnet build

# 运行开发模式
dotnet watch run

# 运行测试
dotnet test

# 数据库迁移
dotnet ef database update
```

### 前端开发
```bash
# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

# 构建生产版本
pnpm build

# 代码检查
pnpm lint
```

### 基础设施管理
```bash
# 启动所有服务
docker-compose up -d

# 查看服务状态
docker-compose ps

# 停止服务
docker-compose down

# 完全清理
docker-compose down -v
```

---

## 🎯 开发约定

### 后端
- 使用 Clean Architecture 分层架构
- 遵循 DDD 领域驱动设计原则
- API 使用 FastEndpoints 框架
- 数据验证使用 FluentValidation
- 使用 MediatR 处理命令查询

### 前端
- 使用 Composition API 风格
- TypeScript 严格模式
- Tailwind CSS 样式系统
- Pinia 状态管理
- Vue Router 路由管理

---

## 📚 学习资源

详细文档请查看: [PROJECT_DOCUMENTATION.md](PROJECT_DOCUMENTATION.md)

主要技术栈文档：
- [.NET 10 官方文档](https://learn.microsoft.com/zh-cn/dotnet/)
- [Vue 3 官方文档](https://vuejs.org/)
- [Tailwind CSS](https://tailwindcss.com/)

---

## ❓ 常见问题

**Q: 后端启动失败，提示数据库连接错误？**
A: 确保 Docker 服务已启动：`docker-compose up -d`

**Q: 前端页面空白？**
A: 检查控制台是否有错误，确认后端 API 是否正常运行

**Q: 需要帮助？**
A: 查看完整文档或联系项目维护者

---

*Happy Coding! 🎉*