feat(admin): implement admin and report endpoints

Author: enverern

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/admin/controller/AdminReportController.java

@@ -0,0 +1,52 @@
+package org.bounswe.jobboardbackend.admin.controller;
+
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.bounswe.jobboardbackend.admin.dto.AdminActionResponse;
+import org.bounswe.jobboardbackend.report.dto.ReportResponse;
+import org.bounswe.jobboardbackend.report.dto.ResolveReportRequest;
+import org.bounswe.jobboardbackend.report.model.enums.ReportableEntityType;
+import org.bounswe.jobboardbackend.report.model.enums.ReportStatus;
+import org.bounswe.jobboardbackend.admin.service.AdminReportService;
+import org.bounswe.jobboardbackend.report.service.ReportService;
+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.*;
+
+@RestController
+@RequestMapping("/api/admin/reports")
+@RequiredArgsConstructor
+@PreAuthorize("hasRole('ROLE_ADMIN')")
+public class AdminReportController {
+
+    private final ReportService reportService;
+    private final AdminReportService adminReportService;
+
+    @GetMapping
+    public ResponseEntity<Page<ReportResponse>> listReports(
+            @RequestParam(required = false) ReportStatus status,
+            @RequestParam(required = false) ReportableEntityType entityType,
+            @PageableDefault(size = 20) Pageable pageable) {
+
+        Page<ReportResponse> reports = reportService.listReports(status, entityType, pageable);
+        return ResponseEntity.ok(reports);
+    }
+
+    @GetMapping("/{id}")
+    public ResponseEntity<ReportResponse> getReport(@PathVariable Long id) {
+        ReportResponse report = reportService.getReport(id);
+        return ResponseEntity.ok(report);
+    }
+
+    @PostMapping("/{id}/resolve")
+    public ResponseEntity<AdminActionResponse> resolveReport(
+            @PathVariable Long id,
+            @Valid @RequestBody ResolveReportRequest request) {
+
+        adminReportService.resolveReport(id, request);
+        return ResponseEntity.ok(new AdminActionResponse("Report resolved successfully"));
+    }
+}

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/admin/dto/AdminActionResponse.java

@@ -0,0 +1,10 @@
+package org.bounswe.jobboardbackend.admin.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+
+@Data
+@AllArgsConstructor
+public class AdminActionResponse {
+    private String message;
+}

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/admin/dto/BanMentorRequest.java

@@ -0,0 +1,8 @@
+package org.bounswe.jobboardbackend.admin.dto;
+
+import lombok.Data;
+
+@Data
+public class BanMentorRequest {
+    private String reason;
+}

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/admin/dto/BanUserRequest.java

@@ -0,0 +1,19 @@
+package org.bounswe.jobboardbackend.admin.dto;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class BanUserRequest {
+
+    @NotBlank(message = "Ban reason must not be blank")
+    @Size(max = 500, message = "Ban reason must be at most 500 characters")
+    private String reason;
+}

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/admin/dto/DeleteContentRequest.java

@@ -0,0 +1,14 @@
+package org.bounswe.jobboardbackend.admin.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class DeleteContentRequest {
+    private String reason;
+}

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/admin/dto/UserListResponse.java

@@ -0,0 +1,24 @@
+package org.bounswe.jobboardbackend.admin.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.bounswe.jobboardbackend.auth.model.Role;
+
+import java.time.Instant;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class UserListResponse {
+
+    private Long id;
+    private String username;
+    private String email;
+    private Role role;
+    private Boolean isBanned;
+    private String banReason;
+    private Instant createdAt;
+}

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/admin/service/AdminForumService.java

@@ -0,0 +1,40 @@
+package org.bounswe.jobboardbackend.admin.service;
+
+import jakarta.transaction.Transactional;
+import lombok.RequiredArgsConstructor;
+import org.bounswe.jobboardbackend.exception.ErrorCode;
+import org.bounswe.jobboardbackend.exception.HandleException;
+import org.bounswe.jobboardbackend.forum.model.ForumComment;
+import org.bounswe.jobboardbackend.forum.model.ForumPost;
+import org.bounswe.jobboardbackend.forum.repository.ForumCommentRepository;
+import org.bounswe.jobboardbackend.forum.repository.ForumPostRepository;
+import org.springframework.stereotype.Service;
+
+@Service
+@RequiredArgsConstructor
+public class AdminForumService {
+
+    private final ForumPostRepository forumPostRepository;
+    private final ForumCommentRepository forumCommentRepository;
+
+    @Transactional
+    public void deletePost(Long postId, String reason) {
+        ForumPost post = forumPostRepository.findById(postId)
+                .orElseThrow(() -> new HandleException(ErrorCode.NOT_FOUND, "Forum post not found"));
+
+        // Cascade delete will handle comments
+        forumPostRepository.delete(post);
+
+        // TODO: Log deletion with reason for audit
+    }
+
+    @Transactional
+    public void deleteComment(Long commentId, String reason) {
+        ForumComment comment = forumCommentRepository.findById(commentId)
+                .orElseThrow(() -> new HandleException(ErrorCode.NOT_FOUND, "Forum comment not found"));
+
+        forumCommentRepository.delete(comment);
+
+        // TODO: Log deletion with reason for audit
+    }
+}

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/admin/service/AdminJobApplicationService.java

@@ -0,0 +1,25 @@
+package org.bounswe.jobboardbackend.admin.service;
+
+import jakarta.transaction.Transactional;
+import lombok.RequiredArgsConstructor;
+import org.bounswe.jobboardbackend.exception.ErrorCode;
+import org.bounswe.jobboardbackend.exception.HandleException;
+import org.bounswe.jobboardbackend.jobapplication.model.JobApplication;
+import org.bounswe.jobboardbackend.jobapplication.repository.JobApplicationRepository;
+import org.springframework.stereotype.Service;
+
+@Service
+@RequiredArgsConstructor
+public class AdminJobApplicationService {
+
+    private final JobApplicationRepository jobApplicationRepository;
+
+    @Transactional
+    public void deleteJobApplication(Long applicationId, String reason) {
+        JobApplication application = jobApplicationRepository.findById(applicationId)
+                .orElseThrow(
+                        () -> new HandleException(ErrorCode.JOB_APPLICATION_NOT_FOUND, "Job application not found"));
+
+        jobApplicationRepository.delete(application);
+    }
+}

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/admin/service/AdminJobPostService.java

@@ -0,0 +1,31 @@
+package org.bounswe.jobboardbackend.admin.service;
+
+import jakarta.transaction.Transactional;
+import lombok.RequiredArgsConstructor;
+import org.bounswe.jobboardbackend.exception.ErrorCode;
+import org.bounswe.jobboardbackend.exception.HandleException;
+import org.bounswe.jobboardbackend.jobpost.model.JobPost;
+import org.bounswe.jobboardbackend.jobpost.repository.JobPostRepository;
+import org.bounswe.jobboardbackend.jobapplication.repository.JobApplicationRepository;
+import org.springframework.stereotype.Service;
+
+@Service
+@RequiredArgsConstructor
+public class AdminJobPostService {
+
+    private final JobPostRepository jobPostRepository;
+    private final JobApplicationRepository jobApplicationRepository;
+
+    @Transactional
+    public void deleteJobPost(Long jobPostId, String reason) {
+        JobPost jobPost = jobPostRepository.findById(jobPostId)
+                .orElseThrow(() -> new HandleException(ErrorCode.JOB_POST_NOT_FOUND, "Job post not found"));
+
+        // Delete related job applications first (cascade)
+        jobApplicationRepository.deleteAllByJobPostId(jobPostId);
+
+        jobPostRepository.delete(jobPost);
+
+        // TODO: Log deletion with reason for audit
+    }
+}

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/admin/service/AdminMentorService.java

@@ -0,0 +1,43 @@
+package org.bounswe.jobboardbackend.admin.service;
+
+import jakarta.transaction.Transactional;
+import lombok.RequiredArgsConstructor;
+
+import org.bounswe.jobboardbackend.auth.model.User;
+import org.bounswe.jobboardbackend.auth.repository.UserRepository;
+import org.bounswe.jobboardbackend.exception.ErrorCode;
+import org.bounswe.jobboardbackend.exception.HandleException;
+import org.bounswe.jobboardbackend.mentorship.service.MentorshipService;
+import org.springframework.stereotype.Service;
+import org.bounswe.jobboardbackend.mentorship.model.MentorProfile;
+import org.bounswe.jobboardbackend.mentorship.repository.MentorProfileRepository;
+
+@Service
+@RequiredArgsConstructor
+public class AdminMentorService {
+
+    private final MentorProfileRepository mentorProfileRepository;
+    private final UserRepository userRepository;
+    private final MentorshipService mentorshipService;
+
+    @Transactional
+    public void deleteMentor(Long mentorProfileId, String reason) {
+        // Get mentor to extract userId
+        MentorProfile mentorProfile = mentorProfileRepository.findById(mentorProfileId)
+                .orElseThrow(() -> new HandleException(ErrorCode.NOT_FOUND, "Mentor profile not found"));
+        Long userId = mentorProfile.getUser().getId();
+
+        // Ban user as mentor
+        User user = userRepository.findById(userId)
+                .orElseThrow(() -> new HandleException(ErrorCode.USER_NOT_FOUND, "User not found"));
+        user.setIsMentorBanned(true);
+        user.setMentorBanReason(reason);
+        userRepository.save(user);
+        userRepository.flush(); // Ensure immediate database update
+
+        // Delete mentor profile
+        mentorshipService.deleteMentorProfile(userId);
+
+        // TODO: Log deletion with reason for audit
+    }
+}