gym-manage/QUICKSTART.md

快速启动指南

环境要求

• JDK 17+
• Maven 3.9+
• PostgreSQL 16+

数据库准备

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

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

启动应用

# 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测试

创建会员

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"
  }'

查询会员

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

创建预约

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

运行测试

# 运行所有测试
mvn test

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

常见问题

1. 数据库连接失败

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

2. 端口被占用

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

3. 依赖下载失败

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

技术支持

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