init: SR System — Helpdesk & ITAM Portal

2026-06-02 13:50:39 +09:00
commit 832c9f096f
262 changed files with 30470 additions and 0 deletions
@@ -0,0 +1,161 @@
+package com.srsystem.controller;
+
+import com.srsystem.dto.ApiResponse;
+import com.srsystem.dto.CreateEquipmentRequest;
+import com.srsystem.dto.CreateMaintenanceRequest;
+import com.srsystem.dto.EquipmentSummary;
+import com.srsystem.dto.UpdateEquipmentRequest;
+import com.srsystem.entity.Equipment;
+import com.srsystem.entity.EquipmentAssignment;
+import com.srsystem.entity.EquipmentMaintenance;
+import com.srsystem.entity.enums.EquipmentStatus;
+import com.srsystem.entity.enums.EquipmentType;
+import com.srsystem.service.EquipmentService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.security.SecurityRequirement;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.web.PageableDefault;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.util.List;
+import java.util.Map;
+
+@Tag(name = "Equipment", description = "IT 자산 관리 API")
+@RestController
+@RequestMapping("/api/v1/equipment")
+@RequiredArgsConstructor
+@SecurityRequirement(name = "bearerAuth")
+public class EquipmentController {
+
+    private final EquipmentService equipmentService;
+
+    @Operation(summary = "장비 목록 조회", description = "필터 조건으로 장비 목록을 조회합니다")
+    @PreAuthorize("hasAnyRole('MANAGER', 'ADMIN')")
+    @GetMapping
+    public ResponseEntity<ApiResponse<Page<Equipment>>> getEquipment(
+            @RequestParam(required = false) String type,
+            @RequestParam(required = false) EquipmentStatus status,
+            @RequestParam(required = false) String keyword,
+            @PageableDefault(size = 20) Pageable pageable) {
+        Page<Equipment> equipment = equipmentService.getEquipment(type, status, keyword, pageable);
+        return ResponseEntity.ok(ApiResponse.ok(equipment));
+    }
+
+    @Operation(summary = "장비 상태별 카운트", description = "장비 상태별 개수를 조회합니다")
+    @PreAuthorize("hasAnyRole('MANAGER', 'ADMIN')")
+    @GetMapping("/summary")
+    public ResponseEntity<ApiResponse<EquipmentSummary>> getSummary() {
+        Map<String, Long> counts = equipmentService.getSummary();
+        EquipmentSummary summary = new EquipmentSummary(counts);
+        return ResponseEntity.ok(ApiResponse.ok(summary));
+    }
+
+    @Operation(summary = "장비 단건 조회", description = "장비 ID 로 단일 장비 정보를 조회합니다")
+    @PreAuthorize("hasAnyRole('MANAGER', 'ADMIN')")
+    @GetMapping("/{equipId}")
+    public ResponseEntity<ApiResponse<Equipment>> getEquipment(@PathVariable Long equipId) {
+        Equipment equipment = equipmentService.getEquipment(equipId);
+        return ResponseEntity.ok(ApiResponse.ok(equipment));
+    }
+
+    @Operation(summary = "장비 생성", description = "새로운 장비를 생성합니다")
+    @PreAuthorize("hasAnyRole('MANAGER', 'ADMIN')")
+    @PostMapping
+    public ResponseEntity<ApiResponse<Equipment>> createEquipment(@Valid @RequestBody CreateEquipmentRequest request) {
+        Equipment equipment = equipmentService.createEquipment(request);
+        return ResponseEntity.ok(ApiResponse.ok("장비가 등록되었습니다", equipment));
+    }
+
+    @Operation(summary = "장비 정보 수정", description = "장비 정보를 수정합니다")
+    @PreAuthorize("hasAnyRole('MANAGER', 'ADMIN')")
+    @PutMapping("/{equipId}")
+    public ResponseEntity<ApiResponse<Equipment>> updateEquipment(
+            @PathVariable Long equipId,
+            @RequestBody UpdateEquipmentRequest request) {
+        Equipment equipment = equipmentService.updateEquipment(equipId, request);
+        return ResponseEntity.ok(ApiResponse.ok("장비 정보가 수정되었습니다", equipment));
+    }
+
+    @Operation(summary = "장비 삭제", description = "장비를 삭제합니다 (Soft Delete)")
+    @PreAuthorize("hasAnyRole('MANAGER', 'ADMIN')")
+    @DeleteMapping("/{equipId}")
+    public ResponseEntity<ApiResponse<Void>> deleteEquipment(@PathVariable Long equipId) {
+        equipmentService.deleteEquipment(equipId);
+        return ResponseEntity.ok(ApiResponse.ok("장비가 삭제되었습니다", null));
+    }
+
+    @Operation(summary = "장비 지급", description = "사용자에게 장비를 지급합니다")
+    @PreAuthorize("hasAnyRole('MANAGER', 'ADMIN')")
+    @PostMapping("/{equipId}/assign")
+    public ResponseEntity<ApiResponse<EquipmentAssignment>> assignEquipment(
+            @PathVariable Long equipId,
+            @RequestBody Map<String, Object> body) {
+        Long userId = ((Number) body.get("userId")).longValue();
+        String condition = (String) body.get("condition");
+        EquipmentAssignment assignment = equipmentService.assignEquipment(equipId, userId, condition);
+        return ResponseEntity.ok(ApiResponse.ok("장비가 지급되었습니다", assignment));
+    }
+
+    @Operation(summary = "장비 반납", description = "장비를 반납합니다")
+    @PreAuthorize("hasAnyRole('MANAGER', 'ADMIN')")
+    @PutMapping("/{equipId}/return")
+    public ResponseEntity<ApiResponse<EquipmentAssignment>> returnEquipment(
+            @PathVariable Long equipId,
+            @RequestBody Map<String, String> body) {
+        EquipmentAssignment assignment = equipmentService.returnEquipment(equipId, body.get("condition"));
+        return ResponseEntity.ok(ApiResponse.ok("장비가 반납되었습니다", assignment));
+    }
+
+    @Operation(summary = "장비 지급 이력 조회", description = "장비의 지급/반납 이력을 조회합니다")
+    @PreAuthorize("hasAnyRole('MANAGER', 'ADMIN')")
+    @GetMapping("/{equipId}/assignments")
+    public ResponseEntity<ApiResponse<List<EquipmentAssignment>>> getAssignments(@PathVariable Long equipId) {
+        List<EquipmentAssignment> assignments = equipmentService.getAssignments(equipId);
+        return ResponseEntity.ok(ApiResponse.ok(assignments));
+    }
+
+    @Operation(summary = "장비 유지보수 이력 조회", description = "장비의 유지보수 이력을 조회합니다")
+    @PreAuthorize("hasAnyRole('MANAGER', 'ADMIN')")
+    @GetMapping("/{equipId}/maintenances")
+    public ResponseEntity<ApiResponse<List<EquipmentMaintenance>>> getMaintenanceHistory(@PathVariable Long equipId) {
+        List<EquipmentMaintenance> history = equipmentService.getMaintenanceHistory(equipId);
+        return ResponseEntity.ok(ApiResponse.ok(history));
+    }
+
+    @Operation(summary = "장비 유지보수 기록 추가", description = "장비의 유지보수 기록을 추가합니다")
+    @PreAuthorize("hasAnyRole('MANAGER', 'ADMIN')")
+    @PostMapping("/{equipId}/maintenance")
+    public ResponseEntity<ApiResponse<EquipmentMaintenance>> addMaintenance(
+            @PathVariable Long equipId,
+            @Valid @RequestBody CreateMaintenanceRequest request) {
+        EquipmentMaintenance maintenance = equipmentService.addMaintenance(equipId, request);
+        return ResponseEntity.ok(ApiResponse.ok("유지보수 기록이 등록되었습니다", maintenance));
+    }
+
+    @Operation(summary = "장비 이미지 추가", description = "장비에 이미지를 추가합니다 (JSONB 배열)")
+    @PreAuthorize("hasAnyRole('MANAGER', 'ADMIN')")
+    @PostMapping("/{equipmentId}/images")
+    public ResponseEntity<ApiResponse<Equipment>> addImage(
+            @PathVariable Long equipmentId,
+            @RequestParam("file") MultipartFile file) {
+        Equipment equipment = equipmentService.addImage(equipmentId, file);
+        return ResponseEntity.ok(ApiResponse.ok("이미지가 추가되었습니다", equipment));
+    }
+
+    @Operation(summary = "장비 이미지 삭제", description = "장비에서 특정 이미지를 삭제합니다")
+    @PreAuthorize("hasAnyRole('MANAGER', 'ADMIN')")
+    @DeleteMapping("/{equipmentId}/images/{imageIndex}")
+    public ResponseEntity<ApiResponse<Equipment>> removeImage(
+            @PathVariable Long equipmentId,
+            @PathVariable int imageIndex) {
+        Equipment equipment = equipmentService.removeImage(equipmentId, imageIndex);
+        return ResponseEntity.ok(ApiResponse.ok("이미지가 삭제되었습니다", equipment));
+    }
+}