Add Data Visualization Endpoints

api/src/main/java/com/codeforcommunity/api/authenticated/IProtectedDataProcessor.java

@@ -0,0 +1,16 @@
+package com.codeforcommunity.api.authenticated;
+
+import com.codeforcommunity.auth.JWTData;
+import com.codeforcommunity.dto.data.MetricsCountryResponse;
+import com.codeforcommunity.dto.data.MetricsSchoolResponse;
+import com.codeforcommunity.dto.data.MetricsTotalResponse;
+import com.codeforcommunity.enums.Country;
+
+public interface IProtectedDataProcessor {
+
+  MetricsTotalResponse getFixedTotalMetrics(JWTData userData);
+
+  MetricsCountryResponse getFixedCountryMetrics(JWTData userData, Country country);
+
+  MetricsSchoolResponse getFixedSchoolMetrics(JWTData userData, int schoolId);
+}

api/src/main/java/com/codeforcommunity/dto/data/MetricGeneric.java

@@ -0,0 +1,28 @@
+package com.codeforcommunity.dto.data;
+
+public class MetricGeneric {
+
+  private Integer totalBooks;
+  private Integer totalStudents;
+
+  public MetricGeneric(Integer totalBooks, Integer totalStudents) {
+    this.totalBooks = totalBooks;
+    this.totalStudents = totalStudents;
+  }
+
+  public Integer getTotalBooks() {
+    return totalBooks;
+  }
+
+  public Integer getTotalStudents() {
+    return totalStudents;
+  }
+
+  public void setTotalBooks(Integer totalBooks) {
+    this.totalBooks = totalBooks;
+  }
+
+  public void setTotalStudents(Integer totalStudents) {
+    this.totalStudents = totalStudents;
+  }
+}

api/src/main/java/com/codeforcommunity/dto/data/MetricsCountryResponse.java

@@ -0,0 +1,95 @@
+package com.codeforcommunity.dto.data;
+
+public class MetricsCountryResponse {
+  private Integer countSchools;
+  private Integer countVolunteerAccounts;
+  private Integer countAdminAccounts;
+  private Float avgCountBooksPerStudent;
+  private Float avgCountStudentLibrariansPerSchool;
+  private Float percentSchoolsWithLibraries;
+  private Integer countStudents;
+  private Integer countBooks;
+
+  public MetricsCountryResponse(
+      Integer countSchools,
+      Integer countVolunteerAccounts,
+      Integer countAdminAccounts,
+      Float avgCountBooksPerStudent,
+      Float avgCountStudentLibrariansPerSchool,
+      Float percentSchoolsWithLibraries,
+      Integer countStudents,
+      Integer countBooks) {
+    this.countSchools = countSchools;
+    this.countVolunteerAccounts = countVolunteerAccounts;
+    this.countAdminAccounts = countAdminAccounts;
+    this.avgCountBooksPerStudent = avgCountBooksPerStudent;
+    this.avgCountStudentLibrariansPerSchool = avgCountStudentLibrariansPerSchool;
+    this.percentSchoolsWithLibraries = percentSchoolsWithLibraries;
+    this.countStudents = countStudents;
+    this.countBooks = countBooks;
+  }
+
+  public Integer getCountSchools() {
+    return countSchools;
+  }
+
+  public void setCountSchools(Integer countSchools) {
+    this.countSchools = countSchools;
+  }
+
+  public Integer getCountVolunteerAccounts() {
+    return countVolunteerAccounts;
+  }
+
+  public void setCountVolunteerAccounts(Integer countVolunteerAccounts) {
+    this.countVolunteerAccounts = countVolunteerAccounts;
+  }
+
+  public Integer getCountAdminAccounts() {
+    return countAdminAccounts;
+  }
+
+  public void setCountAdminAccounts(Integer countAdminAccounts) {
+    this.countAdminAccounts = countAdminAccounts;
+  }
+
+  public Float getAvgCountBooksPerStudent() {
+    return avgCountBooksPerStudent;
+  }
+
+  public void setAvgCountBooksPerStudent(Float avgCountBooksPerStudent) {
+    this.avgCountBooksPerStudent = avgCountBooksPerStudent;
+  }
+
+  public Float getAvgCountStudentLibrariansPerSchool() {
+    return avgCountStudentLibrariansPerSchool;
+  }
+
+  public void setAvgCountStudentLibrariansPerSchool(Float avgCountStudentLibrariansPerSchool) {
+    this.avgCountStudentLibrariansPerSchool = avgCountStudentLibrariansPerSchool;
+  }
+
+  public Float getPercentSchoolsWithLibraries() {
+    return percentSchoolsWithLibraries;
+  }
+
+  public void setPercentSchoolsWithLibraries(Float percentSchoolsWithLibraries) {
+    this.percentSchoolsWithLibraries = percentSchoolsWithLibraries;
+  }
+
+  public Integer getCountBooks() {
+    return countBooks;
+  }
+
+  public void setCountBooks(Integer countBooks) {
+    this.countBooks = countBooks;
+  }
+
+  public Integer getCountStudents() {
+    return countStudents;
+  }
+
+  public void setCountStudents(Integer countStudents) {
+    this.countStudents = countStudents;
+  }
+}

api/src/main/java/com/codeforcommunity/dto/data/MetricsSchoolResponse.java

@@ -0,0 +1,62 @@
+package com.codeforcommunity.dto.data;
+
+public class MetricsSchoolResponse {
+  private Float countBooksPerStudent;
+  private Integer countStudents;
+  private Integer countStudentLibrarians;
+  private Integer netBooksInOut;
+  private Integer countBooks;
+
+  public MetricsSchoolResponse(
+      Float countBooksPerStudent,
+      Integer countStudents,
+      Integer countStudentLibrarians,
+      Integer netBooksInOut,
+      Integer countBooks) {
+    this.countBooksPerStudent = countBooksPerStudent;
+    this.countStudents = countStudents;
+    this.countStudentLibrarians = countStudentLibrarians;
+    this.netBooksInOut = netBooksInOut;
+    this.countBooks = countBooks;
+  }
+
+  public Float getCountBooksPerStudent() {
+    return countBooksPerStudent;
+  }
+
+  public void setCountBooksPerStudent(Float countBooksPerStudent) {
+    this.countBooksPerStudent = countBooksPerStudent;
+  }
+
+  public Integer getCountStudents() {
+    return countStudents;
+  }
+
+  public void setCountStudents(Integer countStudents) {
+    this.countStudents = countStudents;
+  }
+
+  public Integer getCountStudentLibrarians() {
+    return countStudentLibrarians;
+  }
+
+  public void setCountStudentLibrarians(Integer countStudentLibrarians) {
+    this.countStudentLibrarians = countStudentLibrarians;
+  }
+
+  public Integer getNetBooksInOut() {
+    return netBooksInOut;
+  }
+
+  public void setNetBooksInOut(Integer netBooksInOut) {
+    this.netBooksInOut = netBooksInOut;
+  }
+
+  public Integer getCountBooks() {
+    return countBooks;
+  }
+
+  public void setCountBooks(Integer countBooks) {
+    this.countBooks = countBooks;
+  }
+}

api/src/main/java/com/codeforcommunity/dto/data/MetricsTotalResponse.java

@@ -0,0 +1,35 @@
+package com.codeforcommunity.dto.data;
+
+public class MetricsTotalResponse {
+  private Integer countSchools;
+  private Integer countBooks;
+  private Integer countStudents;
+
+  public MetricsTotalResponse(Integer countSchools, Integer countBooks, Integer countStudents) {
+    this.countSchools = countSchools;
+    this.countBooks = countBooks;
+    this.countStudents = countStudents;
+  }
+
+  public Integer getCountSchools() {
+    return countSchools;
+  }
+
+  public void setCountSchools(Integer countSchools) {
+    this.countSchools = countSchools;
+  }
+
+  public Integer getCountBooks() {
+    return countBooks;
+  }
+
+  public void setCountBooks(Integer countBooks) {
+    this.countBooks = countBooks;
+  }
+
+  public Integer getCountStudents() { return countStudents; }
+
+  public void setCountStudents(Integer countStudents) {
+    this.countStudents = countStudents;
+  }
+}

api/src/main/java/com/codeforcommunity/dto/school/School.java

@@ -2,7 +2,6 @@
 
 import com.codeforcommunity.enums.Country;
 import com.codeforcommunity.enums.LibraryStatus;
-import java.util.ArrayList;
 import java.util.List;
 
 public class School {

api/src/main/java/com/codeforcommunity/rest/ApiRouter.java

@@ -1,12 +1,14 @@
 package com.codeforcommunity.rest;
 
 import com.codeforcommunity.api.authenticated.IProtectedCountryProcessor;
+import com.codeforcommunity.api.authenticated.IProtectedDataProcessor;
 import com.codeforcommunity.api.authenticated.IProtectedSchoolProcessor;
 import com.codeforcommunity.api.authenticated.IProtectedUserProcessor;
 import com.codeforcommunity.api.unauthenticated.IAuthProcessor;
 import com.codeforcommunity.auth.JWTAuthorizer;
 import com.codeforcommunity.rest.subrouter.CommonRouter;
 import com.codeforcommunity.rest.subrouter.authenticated.ProtectedCountryRouter;
+import com.codeforcommunity.rest.subrouter.authenticated.ProtectedDataRouter;
 import com.codeforcommunity.rest.subrouter.authenticated.ProtectedSchoolRouter;
 import com.codeforcommunity.rest.subrouter.authenticated.ProtectedUserRouter;
 import com.codeforcommunity.rest.subrouter.unauthenticated.AuthRouter;
@@ -20,18 +22,21 @@ public class ApiRouter implements IRouter {
   private final ProtectedUserRouter protectedUserRouter;
   private final ProtectedCountryRouter protectedCountryRouter;
   private final ProtectedSchoolRouter protectedSchoolRouter;
+  private final ProtectedDataRouter protectedDataRouter;
 
   public ApiRouter(
       JWTAuthorizer jwtAuthorizer,
       IAuthProcessor authProcessor,
       IProtectedUserProcessor protectedUserProcessor,
       IProtectedCountryProcessor protectedCountryProcessor,
-      IProtectedSchoolProcessor protectedSchoolProcessor) {
+      IProtectedSchoolProcessor protectedSchoolProcessor,
+      IProtectedDataProcessor protectedDataProcessor) {
     this.commonRouter = new CommonRouter(jwtAuthorizer);
     this.authRouter = new AuthRouter(authProcessor);
     this.protectedUserRouter = new ProtectedUserRouter(protectedUserProcessor);
     this.protectedCountryRouter = new ProtectedCountryRouter(protectedCountryProcessor);
     this.protectedSchoolRouter = new ProtectedSchoolRouter(protectedSchoolProcessor);
+    this.protectedDataRouter = new ProtectedDataRouter(protectedDataProcessor);
   }
 
   /** Initialize a router and register all route handlers on it. */
@@ -57,6 +62,7 @@ private Router defineProtectedRoutes(Vertx vertx) {
     protectedSubRouter.mountSubRouter("/user", protectedUserRouter.initializeRouter(vertx));
     protectedSubRouter.mountSubRouter("/countries", protectedCountryRouter.initializeRouter(vertx));
     protectedSubRouter.mountSubRouter("/schools", protectedSchoolRouter.initializeRouter(vertx));
+    protectedSubRouter.mountSubRouter("/data", protectedDataRouter.initializeRouter(vertx));
 
     return protectedSubRouter;
   }

api/src/main/java/com/codeforcommunity/rest/FailureHandler.java

@@ -48,12 +48,12 @@ public void handleMissingParameter(RoutingContext ctx, MissingParameterException
   }
 
   public void handleNoReportFound(RoutingContext ctx, NoReportFoundException e) {
-    String message = String.format("Report not found for school with id %d", e.getSchoolId());
+    String message = String.format("Report not found for school with ID %d", e.getSchoolId());
     end(ctx, message, 404);
   }
 
   public void handleNoReportByIdFound(RoutingContext ctx, NoReportByIdFoundException e) {
-    String message = String.format("Report not found for report with id %d", e.getReportId());
+    String message = String.format("Report not found for report with ID %d", e.getReportId());
     end(ctx, message, 404);
   }
 
@@ -64,15 +64,16 @@ public void handleAdminOnlyRoute(RoutingContext ctx) {
 
   public void handleEmailAlreadyInUse(RoutingContext ctx, EmailAlreadyInUseException exception) {
     String message =
-        String.format("Error creating new user, given email %s already used", exception.getEmail());
+        String.format(
+            "Error creating new user, given email '%s' already used", exception.getEmail());
 
     end(ctx, message, 409);
   }
 
   public void handleSchoolAlreadyExists(RoutingContext ctx, SchoolAlreadyExistsException e) {
     String message =
         String.format(
-            "School '%s' already exists in '%s'", e.getSchoolName(), e.getSchoolCountry());
+            "School '%s' already exists in country '%s'", e.getSchoolName(), e.getSchoolCountry());
     end(ctx, message, 409);
   }
 
@@ -175,15 +176,15 @@ public void handleMalformedParameter(RoutingContext ctx, MalformedParameterExcep
   }
 
   public void handleUnknownCountry(RoutingContext ctx, UnknownCountryException exception) {
-    String message = String.format("Unknown country given: %s", exception.getUnknownCountry());
+    String message = String.format("No country found with name %s", exception.getUnknownCountry());
     end(ctx, message, 400);
   }
 
   public void handleUnknownSchoolContact(
       RoutingContext ctx, SchoolContactDoesNotExistException exception) {
     String message =
         String.format(
-            "Unknown contact with id '%d' given for school with id '%d'",
+            "Unknown contact with ID %d given for school with ID %d",
             exception.getContactId(), exception.getSchoolId());
     end(ctx, message, 400);
   }
@@ -194,23 +195,24 @@ public void handleBadImageRequest(RoutingContext ctx) {
   }
 
   public void handleS3FailedUpload(RoutingContext ctx, String exceptionMessage) {
-    String message = "The given file could not be uploaded to AWS S3: " + exceptionMessage;
+    String message =
+        "The given file could not be uploaded to AWS S3 with error: " + exceptionMessage;
     end(ctx, message, 502);
   }
 
   public void handleSchoolDoesNotExist(RoutingContext ctx, SchoolDoesNotExistException e) {
-    String message = String.format("No school found with given id: %d", e.getSchoolId());
+    String message = String.format("No school found with ID %d", e.getSchoolId());
     end(ctx, message, 400);
   }
 
   public void handleBookLogDoesNotExist(RoutingContext ctx, BookLogDoesNotExistException e) {
-    String message = String.format("No book log found with given id: %d", e.getBookId());
+    String message = String.format("No book log found with ID %d", e.getBookId());
     end(ctx, message, 400);
   }
 
   public void handleCsvSerializer(RoutingContext ctx, CsvSerializerException e) {
     String message =
-        String.format("Report with id: %d was unable to be converted to CSV", e.getReportId());
+        String.format("Report with ID %d was unable to be converted to CSV", e.getReportId());
     end(ctx, message, 500);
   }