# 快速启动指南

## 环境要求

- JDK 17+
- Maven 3.9+
- PostgreSQL 16+

## 数据库准备

```bash
# 1. 创建数据库
psql -U postgres
CREATE DATABASE gym_manage;
\q

# 2. 执行初始化脚本
psql -U postgres -d gym_manage -f src/main/resources/schema.sql
```

## 启动应用

```bash
# 1. 编译项目
mvn clean install

# 2. 启动应用
mvn spring-boot:run

# 或者直接运行jar
java -jar target/gym-manage-1.0.0-SNAPSHOT.jar
```

## 访问应用

- 应用地址: http://localhost:8080
- Swagger文档: http://localhost:8080/swagger-ui.html
- 健康检查: http://localhost:8080/actuator/health

## API测试

### 创建会员

```bash
curl -X POST http://localhost:8080/api/v1/members \
  -H "Content-Type: application/json" \
  -d '{
    "tenantId": 1,
    "storeId": 1,
    "name": "张三",
    "phone": "13800138000",
    "gender": "MALE",
    "level": "NORMAL"
  }'
```

### 查询会员

```bash
curl -X GET http://localhost:8080/api/v1/members/1
```

### 创建预约

```bash
curl -X POST http://localhost:8080/api/v1/bookings \
  -H "Content-Type: application/json" \
  -d '{
    "memberId": 1,
    "slotId": 1
  }'
```

## 运行测试

```bash
# 运行所有测试
mvn test

# 运行特定测试
mvn test -Dtest=MemberServiceTest
```

## 常见问题

### 1. 数据库连接失败

检查 application.yml 中的数据库配置是否正确。

### 2. 端口被占用

修改 application.yml 中的 server.port 配置。

### 3. 依赖下载失败

检查 Maven 仓库配置，或使用阿里云镜像。

## 技术支持

- 技术负责人: 张翔
- 邮箱: zhangxiang@example.com