<?xml version="1.0" encoding="UTF-8"?>
<!--
=====================================================
 项目名称 : aroma-service
 技术栈   : Spring Boot 3 + MyBatis-Plus + MySQL + Swagger
 Java版本 : 21
 用途     : 精油与医疗术语管理后端服务
=====================================================
-->

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
         https://maven.apache.org/xsd/maven-4.0.0.xsd">

    <!-- Maven模型版本 -->
    <modelVersion>4.0.0</modelVersion>

    <!-- ============================= -->
    <!-- Spring Boot 父工程（必须） -->
    <!-- 负责依赖版本统一管理 -->
    <!-- ============================= -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.3.3</version>
        <relativePath/>
    </parent>

    <!-- 项目基本信息 -->
    <groupId>com.aroma</groupId>
    <artifactId>aroma-service</artifactId>
    <version>1.0-SNAPSHOT</version>
    <name>aroma-service</name>
    <description>Aroma backend service</description>

    <!-- ============================= -->
    <!-- 全局属性配置 -->
    <!-- ============================= -->
    <properties>
        <!-- Java版本 -->
        <java.version>21</java.version>

        <!-- MyBatis Plus版本 -->
        <mybatis-plus.version>3.5.7</mybatis-plus.version>

        <!-- Swagger版本 -->
        <springdoc.version>2.6.0</springdoc.version>

        <!-- 编码 -->
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <!-- ============================= -->
    <!-- 项目依赖 -->
    <!-- ============================= -->
    <dependencies>

        <!-- ========================= -->
        <!-- Web Starter（REST接口） -->
        <!-- 内含：
             Spring MVC
             Tomcat
             Jackson JSON
        -->
        <!-- ========================= -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <!-- ========================= -->
        <!-- MyBatis-Plus 持久层框架 -->
        <!-- 提供：
             BaseMapper CRUD
             分页
             条件构造器
        -->
        <!-- ========================= -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
            <version>${mybatis-plus.version}</version>
        </dependency>

        <!-- ========================= -->
        <!-- MySQL 数据库驱动 -->
        <!-- 对应数据库：aroma_db -->
        <!-- ========================= -->
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
            <scope>runtime</scope>
        </dependency>

        <!-- ========================= -->
        <!-- Lombok（简化实体类代码）
             自动生成 getter/setter
        -->
        <!-- ========================= -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>

        <!-- ========================= -->
        <!-- Swagger / OpenAPI3 文档 -->
        <!-- 访问地址：
             http://localhost:8080/swagger-ui.html
        -->
        <!-- ========================= -->
        <dependency>
            <groupId>org.springdoc</groupId>
            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
            <version>${springdoc.version}</version>
        </dependency>

        <!-- ========================= -->
        <!-- 配置文件提示（可选）
             application.yml 自动补全
        -->
        <!-- ========================= -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-configuration-processor</artifactId>
            <optional>true</optional>
        </dependency>

        <!-- ========================= -->
        <!-- 单元测试 -->
        <!-- ========================= -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

    </dependencies>

    <!-- ============================= -->
    <!-- 构建配置 -->
    <!-- ============================= -->
    <build>
        <plugins>

            <!-- SpringBoot 打包插件 -->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>

            <!-- Java21 编译插件 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>21</source>
                    <target>21</target>
                </configuration>
            </plugin>

        </plugins>
    </build>

</project>