package com.example.demo.config;

import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Contact;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.info.License;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * OpenAPI / Knife4j 配置类。
 * <p>
 * 配置 Swagger/OpenAPI 接口文档，集成 Knife4j 增强UI。
 * 访问地址：http://localhost:8080/doc.html
 * </p>
 */
@Configuration
public class OpenApiConfig {

    /**
     * 自定义 OpenAPI 信息。
     *
     * @return OpenAPI 实例
     */
    @Bean
    public OpenAPI customOpenAPI() {
        return new OpenAPI()
                .info(new Info()
                        .title("战场态势与任务规划系统 API")
                        .version("1.0.0")
                        .description("""
                                战场态势与任务规划系统 API 文档。
                                集成以下两大核心模块：
                                **1. 事件处理与任务生成模块（EHTG）**
                                - 事件接收与解析、数据清洗与标准化
                                - 高价值目标评估与任务模板匹配
                                - 任务草案生成与发送重试
                                
                                **2. 任务方案管理软件（TMS）**
                                - 集中式/分布式方案列表展示与排序
                                - 方案详情查看与多方案对比分析
                                - 方案重构与版本关联追溯
                                - 方案分发与执行状态监控
                                """)
                        .contact(new Contact()
                                .name("开发团队")
                                .email("dev@example.com"))
                        .license(new License()
                                .name("保密")
                                .url("")));
    }
}
