added season handicap computation endpoints

This commit is contained in:
2025-06-25 16:41:00 -04:00
parent 259f5655b4
commit d5d96fd235

View File

@@ -9,6 +9,7 @@ import io.swagger.v3.oas.annotations.tags.Tag;
import jakarta.annotation.security.RolesAllowed;
import jakarta.validation.constraints.Min;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Positive;
import jakarta.ws.rs.PUT;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.PathParam;
@@ -23,6 +24,29 @@ import jakarta.ws.rs.Produces;
@SecurityRequirement(name = "basic")
public interface AdministrativeApi {
@PUT
@Path("/init/golfer/{personId}/season")
@Operation(description = "Sets up the current season handicap of the specified person for the virtual tournament.")
@ApiResponses({
@ApiResponse(responseCode = "204", description = "Success"),
@ApiResponse(responseCode = "401", description = "Not authenticated"),
@ApiResponse(responseCode = "403", description = "Authenticated, but not permitted"),
@ApiResponse(responseCode = "404", description = "Person not found"),
})
void setupScoringPointSeason(@Parameter(description = "A unique idenifier of a golfer")
@NotNull @Positive @PathParam("personId") long personId);
@PUT
@Path("/init/season")
@Produces(Constants.V1_JSON)
@Operation(description = "Sets up the current season handicaps for the virtual tournament.")
@ApiResponses({
@ApiResponse(responseCode = "200", description = "Success"),
@ApiResponse(responseCode = "401", description = "Not authenticated"),
@ApiResponse(responseCode = "403", description = "Authenticated, but not permitted"),
})
long setupScoringPointSeason();
@PUT
@Path("/init/pointIndex/season/{season:[0-9]{4}}")
@Produces(Constants.V1_JSON)