From 0d70b27653a420ac722d13edf06fab10f9a21abe Mon Sep 17 00:00:00 2001
From: siujamo <jamo.siu@gmail.com>
Date: Tue, 26 May 2026 14:24:56 +0800
Subject: [PATCH] feat: add OpenAPI definition with title, contact, and licence

---
 .../config/OpenApiConfiguration.java          | 26 +++++++++++++++++++
 .../controller/VersionController.java         |  2 ++
 2 files changed, 28 insertions(+)
 create mode 100644 src/main/java/com/onixbyte/deltaforceguide/config/OpenApiConfiguration.java

diff --git a/src/main/java/com/onixbyte/deltaforceguide/config/OpenApiConfiguration.java b/src/main/java/com/onixbyte/deltaforceguide/config/OpenApiConfiguration.java
new file mode 100644
index 0000000..9f47fe1
--- /dev/null
+++ b/src/main/java/com/onixbyte/deltaforceguide/config/OpenApiConfiguration.java
@@ -0,0 +1,26 @@
+package com.onixbyte.deltaforceguide.config;
+
+import io.swagger.v3.oas.annotations.OpenAPIDefinition;
+import io.swagger.v3.oas.annotations.info.Contact;
+import io.swagger.v3.oas.annotations.info.Info;
+import io.swagger.v3.oas.annotations.info.License;
+import org.springframework.context.annotation.Configuration;
+
+@OpenAPIDefinition(
+        info = @Info(
+                title = "Delta Force Guide Server",
+                description = "API for managing Delta Force game firearm builds",
+                version = "1.3.4",
+                contact = @Contact(
+                        name = "Zihlu Wang",
+                        email = "zihlu.wang@onixbyte.com"
+                ),
+                license = @License(
+                        name = "MIT",
+                        url = "https://git.onixbyte.cn/onixbyte/delta-force-guide-server/-/raw/main/LICENCE"
+                )
+        )
+)
+@Configuration
+public class OpenApiConfiguration {
+}
diff --git a/src/main/java/com/onixbyte/deltaforceguide/controller/VersionController.java b/src/main/java/com/onixbyte/deltaforceguide/controller/VersionController.java
index a73b43c..67a08ef 100644
--- a/src/main/java/com/onixbyte/deltaforceguide/controller/VersionController.java
+++ b/src/main/java/com/onixbyte/deltaforceguide/controller/VersionController.java
@@ -2,10 +2,12 @@ package com.onixbyte.deltaforceguide.controller;
 
 import com.onixbyte.deltaforceguide.service.AppService;
 import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
+@Tag(name = "版本信息")
 @RestController
 @RequestMapping("/versions")
 public class VersionController {