dev into main

.gitignore

@@ -1 +1,2 @@
-.idea
+.idea# Generated localization files
+lib/generated/

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/activity/controller/ActivityController.java

@@ -0,0 +1,36 @@
+package org.bounswe.jobboardbackend.activity.controller;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.bounswe.jobboardbackend.activity.model.Activity;
+import org.bounswe.jobboardbackend.activity.service.ActivityService;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.*;
+
+@RestController
+@RequestMapping("/api/activities")
+@RequiredArgsConstructor
+@PreAuthorize("isAuthenticated()")
+@Tag(name = "Activity", description = "Activity Logging and Retrieval API")
+public class ActivityController {
+
+    private final ActivityService activityService;
+
+    @Operation(summary = "Get User Activities", description = "Retrieves a paginated list of activities for a specific user. This endpoint is currently public.")
+    @ApiResponses(value = {
+            @ApiResponse(responseCode = "200", description = "Activities retrieved successfully")
+    })
+    @GetMapping("/user/{userId}")
+    public ResponseEntity<Page<Activity>> getUserActivities(
+            @Parameter(description = "ID of the user") @PathVariable Long userId,
+            @Parameter(hidden = true) Pageable pageable) {
+        return ResponseEntity.ok(activityService.getActivitiesByActor(userId, pageable));
+    }
+}

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/activity/model/Activity.java

@@ -0,0 +1,49 @@
+package org.bounswe.jobboardbackend.activity.model;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.persistence.*;
+import lombok.*;
+import org.bounswe.jobboardbackend.auth.model.User;
+import org.hibernate.annotations.CreationTimestamp;
+
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "activities")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@Schema(description = "Represents a user activity in the system")
+public class Activity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Schema(description = "Unique identifier of the activity", example = "1")
+    private Long id;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "actor_id", nullable = false)
+    @JsonIgnoreProperties({ "hibernateLazyInitializer", "handler" })
+    @Schema(description = "The user who performed the activity")
+    private User actor;
+
+    @Enumerated(EnumType.STRING)
+    @Column(nullable = false)
+    @Schema(description = "Type of the activity", example = "REGISTER")
+    private ActivityType type;
+
+    @Column(name = "entity_id")
+    @Schema(description = "ID of the entity related to the activity", example = "101")
+    private Long entityId;
+
+    @Column(name = "entity_type")
+    @Schema(description = "Type of the entity regarding the activity", example = "User")
+    private String entityType;
+
+    @CreationTimestamp
+    @Column(updatable = false)
+    @Schema(description = "Timestamp when the activity was created")
+    private LocalDateTime createdAt;
+}

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/activity/model/ActivityType.java

@@ -0,0 +1,21 @@
+package org.bounswe.jobboardbackend.activity.model;
+
+public enum ActivityType {
+    REGISTER,
+    UPDATE_PROFILE,
+    CREATE_WORKPLACE,
+    CREATE_JOB,
+    APPLY_JOB,
+    APPROVE_APPLICATION,
+    REJECT_APPLICATION,
+    CREATE_REVIEW,
+    REQUEST_MENTORSHIP,
+    ACCEPT_MENTORSHIP,
+    COMPLETE_MENTORSHIP,
+    CREATE_THREAD,
+    CREATE_COMMENT,
+    UPVOTE_THREAD,
+    DOWNVOTE_THREAD,
+    EDIT_THREAD,
+    DELETE_THREAD
+}

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/activity/repository/ActivityRepository.java

@@ -0,0 +1,14 @@
+package org.bounswe.jobboardbackend.activity.repository;
+
+import org.bounswe.jobboardbackend.activity.model.Activity;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface ActivityRepository extends JpaRepository<Activity, Long> {
+    Page<Activity> findByActorIdOrderByCreatedAtDesc(Long actorId, Pageable pageable);
+
+    void deleteByActorId(Long actorId);
+}

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/activity/service/ActivityService.java

@@ -0,0 +1,35 @@
+package org.bounswe.jobboardbackend.activity.service;
+
+import lombok.RequiredArgsConstructor;
+import org.bounswe.jobboardbackend.activity.model.Activity;
+import org.bounswe.jobboardbackend.activity.model.ActivityType;
+import org.bounswe.jobboardbackend.activity.repository.ActivityRepository;
+import org.bounswe.jobboardbackend.auth.model.User;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.stereotype.Service;
+
+@Service
+@RequiredArgsConstructor
+public class ActivityService {
+
+    private final ActivityRepository activityRepository;
+
+    public void logActivity(User actor, ActivityType type, Long entityId, String entityType) {
+        Activity activity = Activity.builder()
+                .actor(actor)
+                .type(type)
+                .entityId(entityId)
+                .entityType(entityType)
+                .build();
+        activityRepository.save(activity);
+    }
+
+    public Page<Activity> getActivitiesByActor(Long actorId, Pageable pageable) {
+        return activityRepository.findByActorIdOrderByCreatedAtDesc(actorId, pageable);
+    }
+
+    public void deleteActivitiesByUserId(Long userId) {
+        activityRepository.deleteByActorId(userId);
+    }
+}

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

@@ -0,0 +1,85 @@
+package org.bounswe.jobboardbackend.admin.controller;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.ExampleObject;
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import org.bounswe.jobboardbackend.exception.ApiError;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.security.core.Authentication;
+import org.bounswe.jobboardbackend.auth.service.UserDetailsImpl;
+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/report")
+@RequiredArgsConstructor
+@PreAuthorize("hasRole('ROLE_ADMIN') and isAuthenticated()")
+@Tag(name = "Admin Report", description = "Admin Report Management API")
+public class AdminReportController {
+
+        private final ReportService reportService;
+        private final AdminReportService adminReportService;
+
+        @Operation(summary = "List reports", description = "Retrieve a paginated list of reports with optional filtering by status and entity type.")
+        @ApiResponses(value = {
+                        @ApiResponse(responseCode = "200", description = "List of reports retrieved successfully"),
+                        @ApiResponse(responseCode = "401", description = "Unauthorized", content = @Content(mediaType = "application/json", schema = @Schema(implementation = ApiError.class), examples = @ExampleObject(value = "{ \"timestamp\": \"2023-10-01T12:00:00\", \"status\": 401, \"error\": \"Unauthorized\", \"code\": \"USER_UNAUTHORIZED\", \"message\": \"Full authentication is required\", \"path\": \"/api/admin/report\" }"))),
+                        @ApiResponse(responseCode = "403", description = "Forbidden (Admin only)", content = @Content(mediaType = "application/json", schema = @Schema(implementation = ApiError.class), examples = @ExampleObject(value = "{ \"timestamp\": \"2023-10-01T12:00:00\", \"status\": 403, \"error\": \"Forbidden\", \"code\": \"ACCESS_DENIED\", \"message\": \"Access denied\", \"path\": \"/api/admin/report\" }")))
+        })
+        @GetMapping
+        public ResponseEntity<Page<ReportResponse>> listReports(
+                        @Parameter(description = "Filter by report status") @RequestParam(required = false) ReportStatus status,
+                        @Parameter(description = "Filter by entity type") @RequestParam(required = false) ReportableEntityType entityType,
+                        @Parameter(hidden = true) @PageableDefault(size = 20) Pageable pageable){
+
+                Page<ReportResponse> reports = reportService.listReports(status, entityType, pageable);
+                return ResponseEntity.ok(reports);
+        }
+
+        @Operation(summary = "Get report details", description = "Retrieve detailed information about a specific report.")
+        @ApiResponses(value = {
+                        @ApiResponse(responseCode = "200", description = "Report retrieved successfully"),
+                        @ApiResponse(responseCode = "404", description = "Report not found", content = @Content(mediaType = "application/json", schema = @Schema(implementation = ApiError.class), examples = @ExampleObject(value = "{ \"timestamp\": \"2023-10-01T12:00:00\", \"status\": 404, \"error\": \"Not Found\", \"code\": \"NOT_FOUND\", \"message\": \"Report not found\", \"path\": \"/api/admin/report/1\" }")))
+        })
+        @GetMapping("/{id}")
+        public ResponseEntity<ReportResponse> getReport(
+                        @Parameter(description = "ID of the report to retrieve") @PathVariable Long id) {
+                ReportResponse report = reportService.getReport(id);
+                return ResponseEntity.ok(report);
+        }
+
+        @Operation(summary = "Resolve a report", description = "Take action on a report (resolve, reject) and optionally delete content or ban user.")
+        @ApiResponses(value = {
+                        @ApiResponse(responseCode = "200", description = "Report resolved successfully"),
+                        @ApiResponse(responseCode = "400", description = "Invalid request or action", content = @Content(mediaType = "application/json", schema = @Schema(implementation = ApiError.class), examples = @ExampleObject(value = "{ \"timestamp\": \"2023-10-01T12:00:00\", \"status\": 400, \"error\": \"Bad Request\", \"code\": \"BAD_REQUEST\", \"message\": \"Invalid resolution status\", \"path\": \"/api/admin/report/1/resolve\" }"))),
+                        @ApiResponse(responseCode = "404", description = "Report not found", content = @Content(mediaType = "application/json", schema = @Schema(implementation = ApiError.class), examples = @ExampleObject(value = "{ \"timestamp\": \"2023-10-01T12:00:00\", \"status\": 404, \"error\": \"Not Found\", \"code\": \"NOT_FOUND\", \"message\": \"Report not found\", \"path\": \"/api/admin/report/1/resolve\" }")))
+        })
+        @PostMapping("/{id}/resolve")
+        public ResponseEntity<AdminActionResponse> resolveReport(
+                        @Parameter(description = "ID of the report to resolve") @PathVariable Long id,
+                        @Valid @RequestBody ResolveReportRequest request,
+                        Authentication auth) {
+
+                UserDetailsImpl userDetails = (UserDetailsImpl) auth
+                                .getPrincipal();
+                adminReportService.resolveReport(id, request, userDetails.getId());
+                return ResponseEntity.ok(new AdminActionResponse("Report resolved successfully"));
+        }
+}

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

@@ -0,0 +1,12 @@
+package org.bounswe.jobboardbackend.admin.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+
+@Data
+@AllArgsConstructor
+public class AdminActionResponse {
+    @Schema(description = "Message indicating the result of the action", example = "Report resolved successfully")
+    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,23 @@
+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,24 @@
+package org.bounswe.jobboardbackend.admin.service;
+
+import jakarta.transaction.Transactional;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.bounswe.jobboardbackend.auth.model.User;
+import org.bounswe.jobboardbackend.forum.service.ForumService;
+
+@Service
+@RequiredArgsConstructor
+public class AdminForumService {
+
+    private final ForumService forumService;
+
+    @Transactional
+    public void deletePost(Long postId, User adminUser, String reason) {
+        forumService.deletePost(postId, adminUser);
+    }
+
+    @Transactional
+    public void deleteComment(Long commentId, User adminUser, String reason) {
+        forumService.deleteComment(commentId, adminUser);
+    }
+}

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);
+    }
+}