# backend-server-starter

**Repository Path**: shengdev/backend-server-starter

## Basic Information

- **Project Name**: backend-server-starter
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2026-05-31
- **Last Updated**: 2026-05-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Pro Skill Backend

Spring Boot 后端服务。

## 本地开发前置准备

1. 在 `src/main/resources/` 目录下创建 `application-local.properties`，填写本机数据库连接信息（参考同目录下的同名模板文件）：

    ```properties
    db.host=localhost
    db.port=3306
    db.name=pro_skill_0

    spring.datasource.url=jdbc:mysql://${db.host}:${db.port}/${db.name}?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
    spring.datasource.username=root
    spring.datasource.password=your_password
    ```

   > 此文件已加入 `.gitignore`，不会被提交。

2. 创建数据库 `pro_skill`：

    打开 MySQL 命令行或客户端工具，执行：

    ```sql
    CREATE DATABASE pro_skill DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
    ```

    或使用命令行：

    ```bash
    mysql -u root -p -e "CREATE DATABASE pro_skill DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
    ```

    > Flyway 会在应用启动时自动执行迁移脚本，无需手动建表。

## 启动

```bash
# 使用项目自带的 Maven Wrapper（推荐，自动使用阿里云镜像）
./mvnw spring-boot:run

# 或先打包再运行
./mvnw package -DskipTests
java -jar target/pro-skill-0.0.1-SNAPSHOT.jar
```

## Swagger UI

服务启动后，浏览器打开：

```
http://localhost:8080/swagger-ui.html
```

Swagger UI 右上角会显示 `Authorize` 按钮。点击后填入登录接口返回的 JWT Token，格式为：

```text
Bearer your_jwt_token
```

确认后，后续已受保护接口的调试请求会自动带上该 Token。

OpenAPI 原始 JSON 地址：

```
http://localhost:8080/v3/api-docs
```

## 健康检查（Actuator）

```
http://localhost:8080/actuator/health
```

## Agent Skills

本项目定义了以下 Agent Skills，帮助在特定场景下提升开发效率：

### unit-test

生成符合分层架构的组件/单元测试。

**触发场景：**
- 用户要求编写单元测试、组件测试
- 用户要求为 Service、Controller、Domain、Mapper 添加测试

**测试分层策略：**

| 层级 | 测试类型 | 工具 |
|------|---------|------|
| Domain | Pure Unit Test | JUnit 5，直接实例化 |
| Application (Service) | Mockito Test | `@ExtendWith(MockitoExtension.class)` |
| Controller | MockMvc Test | `@WebMvcTest` |
| Mapper | MyBatis Test | `@MybatisTest` |

详细用法见 [.trae/skills/unit-test/SKILL.md](.trae/skills/unit-test/SKILL.md)。