feat: v1 controllers

API.md

@@ -126,13 +126,4 @@ class data {
 
 # ws://localhost:8080/ws
 
-几乎所有的ws请求都需要先在`http`请求中获取`ticket`
+目前不支持WS
-
-## /test
-
-回复：
-
-```typescript
-`Kotlin springboot4 received: ${userText}`
-```
-

README.md

@@ -15,8 +15,16 @@
       - /ask-code
       - /register
       - /reset
-- /ws
+    - /departments
-    - /test
+    - /email
+    - /evaluation-records
+    - /finance
+    - /items
+    - /memos
+    - /personnel
+    - /project-groups
+    - /proof-images
+    - /usages
 
 ## 预计完成的 API 列表
 
@@ -78,7 +86,7 @@
 ### 4. **邮件通知 (Email Notice)** - `/api/`
 
 | 端点                       | 方法       | 功能说明           |
-|------|------|--------|
+|--------------------------|----------|----------------|
 | `notification-settings/` | GET/POST | 获取/更新通知设置和邮箱列表 |
 | `toggle-email-status/`   | POST     | 切换邮箱启用/禁用状态    |
 

src/beckend/src/main/kotlin/club/itstudio/itmanager/controller/v1/AuthorizeController.kt

@@ -1,4 +1,4 @@
-package club.itstudio.itmanager.controller
+package club.itstudio.itmanager.controller.v1
 
 import club.itstudio.itmanager.entity.ApiResponse
 import club.itstudio.itmanager.entity.vo.request.EmailRegisterVO
@@ -10,13 +10,18 @@ import jakarta.validation.constraints.NotBlank
 import jakarta.validation.constraints.Pattern
 import org.slf4j.LoggerFactory
 import org.springframework.validation.annotation.Validated
-import org.springframework.web.bind.annotation.*
+import org.springframework.web.bind.annotation.GetMapping
+import org.springframework.web.bind.annotation.PostMapping
+import org.springframework.web.bind.annotation.RequestBody
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RequestParam
+import org.springframework.web.bind.annotation.RestController
 import org.springframework.web.server.ServerWebExchange
 import reactor.core.publisher.Mono
 
 @Validated
 @RestController
-@RequestMapping("/api/auth")
+@RequestMapping("/api/v1/auth")
 class AuthorizeController(
     private val service: AccountService
 ) {

src/beckend/src/main/kotlin/club/itstudio/itmanager/controller/v1/DepartmentsController.kt

@@ -0,0 +1,11 @@
+package club.itstudio.itmanager.controller.v1
+
+import org.springframework.validation.annotation.Validated
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+@Validated
+@RestController
+@RequestMapping("/api/v1/department")
+class DepartmentsController {
+}

src/beckend/src/main/kotlin/club/itstudio/itmanager/controller/v1/EmailController.kt

@@ -0,0 +1,11 @@
+package club.itstudio.itmanager.controller.v1
+
+import org.springframework.validation.annotation.Validated
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+@Validated
+@RestController
+@RequestMapping("/api/v1/email")
+class EmailController {
+}

src/beckend/src/main/kotlin/club/itstudio/itmanager/controller/v1/EvaluationRecordsController.kt

@@ -0,0 +1,11 @@
+package club.itstudio.itmanager.controller.v1
+
+import org.springframework.validation.annotation.Validated
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+@Validated
+@RestController
+@RequestMapping("/api/v1/evaluation-records")
+class EvaluationRecordsController {
+}

src/beckend/src/main/kotlin/club/itstudio/itmanager/controller/v1/FinanceController.kt

@@ -0,0 +1,11 @@
+package club.itstudio.itmanager.controller.v1
+
+import org.springframework.validation.annotation.Validated
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+@Validated
+@RestController
+@RequestMapping("/api/v1/finance")
+class FinanceController {
+}

src/beckend/src/main/kotlin/club/itstudio/itmanager/controller/v1/ItemsController.kt

@@ -0,0 +1,11 @@
+package club.itstudio.itmanager.controller.v1
+
+import org.springframework.validation.annotation.Validated
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+@Validated
+@RestController
+@RequestMapping("/api/v1/items")
+class ItemsController {
+}

src/beckend/src/main/kotlin/club/itstudio/itmanager/controller/v1/MemosController.kt

@@ -0,0 +1,11 @@
+package club.itstudio.itmanager.controller.v1
+
+import org.springframework.validation.annotation.Validated
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+@Validated
+@RestController
+@RequestMapping("/api/v1/memos")
+class MemosController {
+}

src/beckend/src/main/kotlin/club/itstudio/itmanager/controller/v1/PersonnelController.kt

@@ -0,0 +1,11 @@
+package club.itstudio.itmanager.controller.v1
+
+import org.springframework.validation.annotation.Validated
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+@Validated
+@RestController
+@RequestMapping("/api/v1/personnel")
+class PersonnelController {
+}

src/beckend/src/main/kotlin/club/itstudio/itmanager/controller/v1/ProjectGroupsController.kt

@@ -0,0 +1,11 @@
+package club.itstudio.itmanager.controller.v1
+
+import org.springframework.validation.annotation.Validated
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+@Validated
+@RestController
+@RequestMapping("/api/v1/project-groups")
+class ProjectGroupsController {
+}

src/beckend/src/main/kotlin/club/itstudio/itmanager/controller/v1/ProofImagesController.kt

@@ -0,0 +1,11 @@
+package club.itstudio.itmanager.controller.v1
+
+import org.springframework.validation.annotation.Validated
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+@Validated
+@RestController
+@RequestMapping("/api/v1/proof-images")
+class ProofImagesController {
+}

src/beckend/src/main/kotlin/club/itstudio/itmanager/controller/v1/UsagesController.kt

@@ -0,0 +1,11 @@
+package club.itstudio.itmanager.controller.v1
+
+import org.springframework.validation.annotation.Validated
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+@Validated
+@RestController
+@RequestMapping("/api/v1/usages")
+class UsagesController {
+}