feat: Add Community Dashboard API

- Implemented public dashboard endpoint with scheduled caching for performance.
- Added statistics for users, jobs, and applications.
- Stats for mentorship and forum are mock for now

Author: buraktigin

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/JobboardBackendApplication.java

@@ -2,8 +2,10 @@
 
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.scheduling.annotation.EnableScheduling;
 
 @SpringBootApplication
+@EnableScheduling
 public class JobboardBackendApplication {
 
     public static void main(String[] args) {

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/auth/repository/UserRepository.java

@@ -1,5 +1,6 @@
 package org.bounswe.jobboardbackend.auth.repository;
 
+import org.bounswe.jobboardbackend.auth.model.Role;
 import org.bounswe.jobboardbackend.auth.model.User;
 import org.springframework.data.jpa.repository.JpaRepository;
 import org.springframework.stereotype.Repository;
@@ -15,4 +16,6 @@ public interface UserRepository extends JpaRepository<User, Long> {
     Boolean existsByEmail(String email);
 
     Optional<User> findByEmail(String email);
+
+    long countByRole(Role role);
 }

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/dashboard/controller/CommunityDashboardController.java

@@ -0,0 +1,22 @@
+package org.bounswe.jobboardbackend.dashboard.controller;
+
+import lombok.RequiredArgsConstructor;
+import org.bounswe.jobboardbackend.dashboard.dto.DashboardStatsResponse;
+import org.bounswe.jobboardbackend.dashboard.service.CommunityDashboardService;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/api/public/dashboard")
+@RequiredArgsConstructor
+public class CommunityDashboardController {
+
+    private final CommunityDashboardService dashboardService;
+
+    @GetMapping
+    public ResponseEntity<DashboardStatsResponse> getDashboardStats() {
+        return ResponseEntity.ok(dashboardService.getStats());
+    }
+}

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/dashboard/dto/DashboardStatsResponse.java

@@ -0,0 +1,30 @@
+package org.bounswe.jobboardbackend.dashboard.dto;
+
+import lombok.*;
+
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class DashboardStatsResponse {
+
+    // user related stats
+    private long totalUsers;
+    private long totalEmployers;
+    private long totalJobSeekers;
+
+    private long totalForumPosts;      // mock for now
+    private long currentMentorships;   // mock for now
+
+    // job post  related stats
+    private long totalJobPosts;
+    private long remoteJobsCount;
+    private long inclusiveJobsCount;
+    private long newJobsThisWeekCount;
+
+    // job application related stats
+    private long totalApplications;
+    private long totalPendingApplications;
+    private long totalAcceptedApplications;
+    private long totalRejectedApplications;
+}

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/dashboard/service/CommunityDashboardService.java

@@ -0,0 +1,76 @@
+package org.bounswe.jobboardbackend.dashboard.service;
+
+import jakarta.annotation.PostConstruct;
+import lombok.RequiredArgsConstructor;
+import org.bounswe.jobboardbackend.auth.model.Role; // Role Enum importu
+import org.bounswe.jobboardbackend.auth.repository.UserRepository;
+import org.bounswe.jobboardbackend.dashboard.dto.DashboardStatsResponse;
+import org.bounswe.jobboardbackend.jobapplication.model.JobApplicationStatus;
+import org.bounswe.jobboardbackend.jobapplication.repository.JobApplicationRepository;
+import org.bounswe.jobboardbackend.jobpost.repository.JobPostRepository;
+import org.springframework.scheduling.annotation.Scheduled;
+import org.springframework.stereotype.Service;
+
+import java.time.LocalDateTime;
+
+@Service
+@RequiredArgsConstructor
+public class CommunityDashboardService {
+
+    private final UserRepository userRepository;
+    private final JobPostRepository jobPostRepository;
+    private final JobApplicationRepository jobApplicationRepository;
+
+    private DashboardStatsResponse cachedStats = new DashboardStatsResponse();
+
+    @PostConstruct
+    public void init() {
+        refreshStats();
+    }
+
+    @Scheduled(fixedRate = 86400000)
+    public void refreshStats() {
+        // 1. User Stats
+        long totalUsers = userRepository.count();
+        long totalEmployers = userRepository.countByRole(Role.ROLE_EMPLOYER);
+        long totalJobSeekers = userRepository.countByRole(Role.ROLE_JOBSEEKER);
+
+        // 2. Job Post Stats
+        long totalJobPosts = jobPostRepository.count();
+        long remoteJobs = jobPostRepository.countByRemoteTrue();
+        long inclusiveJobs = jobPostRepository.countByInclusiveOpportunityTrue();
+        long newJobs = jobPostRepository.countByPostedDateAfter(LocalDateTime.now().minusDays(7));
+
+        // 3. Job Application Stats
+        long totalApps = jobApplicationRepository.count();
+        long pendingApps = jobApplicationRepository.countByStatus(JobApplicationStatus.PENDING);
+        long acceptedApps = jobApplicationRepository.countByStatus(JobApplicationStatus.APPROVED);
+        long rejectedApps = jobApplicationRepository.countByStatus(JobApplicationStatus.REJECTED);
+
+        // mock for now
+        long forumPosts = 0;
+        long mentorships = 0;
+
+
+        // update the cached stats
+        this.cachedStats = DashboardStatsResponse.builder()
+                .totalUsers(totalUsers)
+                .totalEmployers(totalEmployers)
+                .totalJobSeekers(totalJobSeekers)
+                .totalJobPosts(totalJobPosts)
+                .totalForumPosts(forumPosts)
+                .currentMentorships(mentorships)
+                .remoteJobsCount(remoteJobs)
+                .inclusiveJobsCount(inclusiveJobs)
+                .newJobsThisWeekCount(newJobs)
+                .totalApplications(totalApps)
+                .totalPendingApplications(pendingApps)
+                .totalAcceptedApplications(acceptedApps)
+                .totalRejectedApplications(rejectedApps)
+                .build();
+    }
+
+    public DashboardStatsResponse getStats() {
+        return this.cachedStats;
+    }
+}

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/jobapplication/repository/JobApplicationRepository.java

@@ -16,4 +16,7 @@ public interface JobApplicationRepository extends JpaRepository<JobApplication,
     List<JobApplication> findByJobPost_Workplace_Id(Long workplaceId);
 
     boolean existsByJobSeekerIdAndJobPostId(Long jobSeekerId, Long jobPostId);
+
+    // needed for stats
+    long countByStatus(org.bounswe.jobboardbackend.jobapplication.model.JobApplicationStatus status);
 }

apps/jobboard-backend/src/main/java/org/bounswe/jobboardbackend/jobpost/repository/JobPostRepository.java

@@ -38,4 +38,11 @@ List<JobPost> findFiltered(
             @Param("nonProfit") Boolean nonProfit
     );
 
+    // needed for stats
+    long countByRemoteTrue();
+
+    long countByInclusiveOpportunityTrue();
+
+    long countByPostedDateAfter(java.time.LocalDateTime date);
+
 }