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>配置应用接口文档的基本信息，包括标题、版本、联系人等。</p>
 */
@Configuration
public class OpenApiConfig {

    /**
     * 构建自定义 OpenAPI 元信息对象。
     *
     * @return 配置完成的 OpenAPI 实例
     */
    @Bean
    public OpenAPI customOpenAPI() {
        return new OpenAPI()
                .info(new Info()
                        .title("信息管理系统（IMS）接口文档")
                        .version("1.0.0")
                        .description("信息管理系统（IMS）一体化综合业务管理平台 RESTful API 文档。\n\n" +
                                "涵盖用户管理、角色管理、部门管理、业务数据管理、日志审计、系统配置等模块。")
                        .contact(new Contact()
                                .name("IMS 开发团队")
                                .email("dev@example.com"))
                        .license(new License()
                                .name("Apache 2.0")
                                .url("https://www.apache.org/licenses/LICENSE-2.0.html")));
    }
}
