eckden
/
memberflow-docker
mirror of https://github.com/DennisEckerskorn/memberflow-docker.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Added and revised javadoc

This commit is contained in:
Dennis Eckerskorn 2025-05-29 21:40:02 +02:00
parent c59d9cb1be
commit ea38bf0f0b
75 changed files with 1828 additions and 151 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
docker/docker-compose.yml
View File

@ -45,13 +45,3 @@ services:
- backend
ports:
- "3000:80"
db-restore:
image: mysql:8.0
depends_on:
mysql:
condition: service_healthy
volumes:
- ./backup.sql:/backup.sql
- ./docker/initdb.sh:/docker-entrypoint-initdb.d/initdb.sh
entrypoint: ["/bin/bash", "/docker-entrypoint-initdb.d/initdb.sh"]

BIN
memberflow-api/libs/memberflow-data-1.0-SNAPSHOT.jar
View File

Binary file not shown.

3
memberflow-api/src/main/java/com/denniseckerskorn/MemberFlowApplication.java
View File

@ -3,6 +3,9 @@ package com.denniseckerskorn;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
/**
* Main application class for the MemberFlow application.
*/
@SpringBootApplication
public class MemberFlowApplication {
public static void main(String[] args) {

26
memberflow-api/src/main/java/com/denniseckerskorn/config/SecurityConfig.java
View File

@ -14,27 +14,53 @@ import org.springframework.security.crypto.password.PasswordEncoder;
import org.springframework.security.web.SecurityFilterChain;
import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter;
/**
* Security configuration class for the application.
*/
@EnableMethodSecurity
@Configuration
public class SecurityConfig {
private final JwtAuthFilter jwtAuthFilter;
private final CustomUserDetailsService customUserDetailsService;
/**
* Constructor for SecurityConfig.
*
* @param jwtAuthFilter the JWT authentication filter
* @param customUserDetailsService the custom user details service
*/
public SecurityConfig(JwtAuthFilter jwtAuthFilter, CustomUserDetailsService customUserDetailsService) {
this.jwtAuthFilter = jwtAuthFilter;
this.customUserDetailsService = customUserDetailsService;
}
/**
* Bean for PasswordEncoder.
*
* @return a BCryptPasswordEncoder instance
*/
@Bean
public PasswordEncoder passwordEncoder() {
return new BCryptPasswordEncoder();
}
/**
* Bean for CustomUserDetailsService.
*
* @return the custom user details service
*/
@Bean
public AuthenticationManager authenticationManager(AuthenticationConfiguration config) throws Exception {
return config.getAuthenticationManager();
}
/**
* Bean for SecurityFilterChain.
*
* @param http the HttpSecurity object
* @return a SecurityFilterChain instance
* @throws Exception if an error occurs during configuration
*/
@Bean
public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
return http

21
memberflow-api/src/main/java/com/denniseckerskorn/config/SwaggerConfig.java
View File

@ -8,9 +8,18 @@ import io.swagger.v3.oas.models.security.SecurityScheme;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
* Swagger configuration class for the MemberFlow API.
* This class sets up the OpenAPI documentation for the API, including security schemes and metadata.
*/
@Configuration
public class SwaggerConfig {
/**
* Configures the OpenAPI documentation for the MemberFlow API.
*
* @return an OpenAPI instance with the API information and security scheme.
*/
@Bean
public OpenAPI customOpenAPI() {
final String securitySchemeName = "bearerAuth";
@ -20,12 +29,12 @@ public class SwaggerConfig {
.title("MemberFlow API")
.version("1.0.0")
.description("""
Documentación de la API de MemberFlow.
**Usuarios de prueba:**
- Admin: admin@example.com / admin123
- Teacher: teacher@example.com / 123456789
- Student: student@example.com / 12345678
""")
Documentación de la API de MemberFlow.
**Usuarios de prueba:**
- Admin: admin@example.com / admin123
- Teacher: teacher@example.com / 123456789
- Student: student@example.com / 12345678
""")
)
.addSecurityItem(new SecurityRequirement().addList(securitySchemeName))
.components(new Components()

4
memberflow-api/src/main/java/com/denniseckerskorn/config/WebConfig.java
View File

@ -4,6 +4,10 @@ import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.CorsRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
/**
* Web configuration class for setting up CORS mappings.
* This class allows cross-origin requests from specified origins.
*/
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override

17
memberflow-api/src/main/java/com/denniseckerskorn/controllers/AuthController.java
View File

@ -14,6 +14,10 @@ import org.springframework.security.authentication.UsernamePasswordAuthenticatio
import org.springframework.security.crypto.password.PasswordEncoder;
import org.springframework.web.bind.annotation.*;
/**
* AuthController handles user authentication requests.
* It provides an endpoint for user login, which returns a JWT token upon successful authentication.
*/
@RestController
@RequestMapping("/api/v1/auth")
@Tag(name = "Authentication", description = "Operations related to user authentication")
@ -23,12 +27,25 @@ public class AuthController {
private final JwtUtil jwtUtil;
private final UserService userService;
/**
* Constructor for AuthController.
*
* @param authenticationManager Authentication manager for handling authentication requests.
* @param jwtUtil Utility class for generating JWT tokens.
* @param userService Service for handling user-related operations.
*/
public AuthController(AuthenticationManager authenticationManager, JwtUtil jwtUtil, UserService userService) {
this.authenticationManager = authenticationManager;
this.jwtUtil = jwtUtil;
this.userService = userService;
}
/**
* API response codes for the login endpoint.
*
* @param loginRequest The login request containing user credentials.
* @return ResponseEntity containing the JWT token or an error message.
*/
@ApiResponses(value = {
@ApiResponse(responseCode = "200", description = "Successful login"),
@ApiResponse(responseCode = "401", description = "Unauthorized"),

41
memberflow-api/src/main/java/com/denniseckerskorn/controllers/class_management_controllers/AssistanceController.java
View File

@ -17,6 +17,10 @@ import org.springframework.web.bind.annotation.*;
import java.util.List;
import java.util.stream.Collectors;
/**
* AssistanceController handles requests related to assistance management.
* It provides endpoints for creating, updating, retrieving, and deleting assistance records.
*/
@RestController
@RequestMapping("/api/v1/assistances")
@Tag(name = "Assistance Management", description = "Operations related to assistance management")
@ -26,6 +30,13 @@ public class AssistanceController {
private final StudentService studentService;
private final TrainingSessionService trainingSessionService;
/**
* Constructor for AssistanceController.
*
* @param assistanceService Service for handling assistance records.
* @param studentService Service for handling student records.
* @param trainingSessionService Service for handling training session records.
*/
public AssistanceController(
AssistanceService assistanceService,
StudentService studentService,
@ -36,6 +47,12 @@ public class AssistanceController {
this.trainingSessionService = trainingSessionService;
}
/**
* Creates a new assistance record.
*
* @param dto The AssistanceDTO containing the details of the assistance to be created.
* @return ResponseEntity containing the created AssistanceDTO.
*/
@Operation(summary = "Create a new assistance record")
@PostMapping("/create")
public ResponseEntity<AssistanceDTO> create(@RequestBody AssistanceDTO dto) {
@ -52,7 +69,12 @@ public class AssistanceController {
return ResponseEntity.ok(AssistanceDTO.fromEntity(saved));
}
/**
* Updates an existing assistance record.
*
* @param dto The AssistanceDTO containing the updated details of the assistance.
* @return ResponseEntity containing the updated AssistanceDTO.
*/
@Operation(summary = "Update an existing assistance record", description = "Update an existing assistance record")
@PutMapping("/update")
public ResponseEntity<AssistanceDTO> update(@RequestBody AssistanceDTO dto) {
@ -64,6 +86,11 @@ public class AssistanceController {
return ResponseEntity.ok(AssistanceDTO.fromEntity(updated));
}
/**
* Retrieves all assistance records.
*
* @return ResponseEntity containing a list of AssistanceDTOs.
*/
@Operation(summary = "Get all assistance records", description = "Retrieve a list of all assistance records")
@GetMapping("/getAll")
public ResponseEntity<List<AssistanceDTO>> getAll() {
@ -74,6 +101,12 @@ public class AssistanceController {
return ResponseEntity.ok(list);
}
/**
* Retrieves assistance records by student ID.
*
* @param id The ID of the student whose assistance records are to be retrieved.
* @return ResponseEntity containing a list of AssistanceDTOs for the specified student.
*/
@Operation(summary = "Get assistance records by student ID", description = "Retrieve assistance records for a specific student")
@GetMapping("/getById/{id}")
public ResponseEntity<AssistanceDTO> getAssistanceById(@PathVariable Integer id) {
@ -81,6 +114,12 @@ public class AssistanceController {
return ResponseEntity.ok(AssistanceDTO.fromEntity(assistance));
}
/**
* Deletes an assistance record by ID.
*
* @param id The ID of the assistance record to be deleted.
* @return ResponseEntity indicating the result of the deletion operation.
*/
@Operation(summary = "Delete an assistance record by ID")
@DeleteMapping("/delete/{id}")
public ResponseEntity<Void> delete(@PathVariable Integer id) {

35
memberflow-api/src/main/java/com/denniseckerskorn/controllers/class_management_controllers/MembershipController.java
View File

@ -24,10 +24,21 @@ public class MembershipController {
private final MembershipService membershipService;
/**
* Constructor for MembershipController.
*
* @param membershipService Service for handling membership records.
*/
public MembershipController(MembershipService membershipService) {
this.membershipService = membershipService;
}
/**
* Creates a new membership.
*
* @param membershipDTO The MembershipDTO containing the details of the membership to be created.
* @return ResponseEntity containing the created MembershipDTO.
*/
@Operation(summary = "Create a new membership")
@PostMapping("/create")
public ResponseEntity<MembershipDTO> createMembership(@RequestBody MembershipDTO membershipDTO) {
@ -36,6 +47,11 @@ public class MembershipController {
return ResponseEntity.status(HttpStatus.CREATED).body(MembershipDTO.fromEntity(savedMembership));
}
/**
* Retrieves all memberships.
*
* @return ResponseEntity containing a list of MembershipDTOs.
*/
@Operation(summary = "Get all memberships", description = "Retrieve a list of all memberships")
@GetMapping("/getAll")
public ResponseEntity<List<MembershipDTO>> getAllMemberships() {
@ -49,6 +65,12 @@ public class MembershipController {
return ResponseEntity.ok(dtos);
}
/**
* Retrieves a membership by its ID.
*
* @param id The ID of the membership to retrieve.
* @return ResponseEntity containing the MembershipDTO if found, or 404 Not Found if not found.
*/
@Operation(summary = "Get a membership by ID", description = "Retrieve a membership by its ID")
@GetMapping("/getById/{id}")
public ResponseEntity<MembershipDTO> getMembershipById(@PathVariable Integer id) {
@ -56,6 +78,13 @@ public class MembershipController {
return ResponseEntity.ok(MembershipDTO.fromEntity(membership));
}
/**
* Updates an existing membership.
*
* @param id The ID of the membership to update.
* @param dto The MembershipDTO containing the updated details of the membership.
* @return ResponseEntity containing the updated MembershipDTO.
*/
@Operation(summary = "Update a membership", description = "Update an existing membership")
@Transactional
@PutMapping("/update/{id}")
@ -65,6 +94,12 @@ public class MembershipController {
return ResponseEntity.ok(MembershipDTO.fromEntity(updated));
}
/**
* Deletes a membership by its ID.
*
* @param id The ID of the membership to delete.
* @return ResponseEntity indicating the result of the deletion operation.
*/
@Operation(summary = "Delete a membership", description = "Delete a membership by its ID")
@Transactional
@DeleteMapping("/delete/{id}")

67
memberflow-api/src/main/java/com/denniseckerskorn/controllers/class_management_controllers/TrainingGroupController.java
View File

@ -29,7 +29,6 @@ import java.util.stream.Collectors;
* Controller for managing training groups.
* Provides endpoints for creating, updating, retrieving, and deleting training groups.
*/
@RestController
@RequestMapping("/api/v1/training-groups")
@Tag(name = "Training Group Management", description = "Operations related to training group management")
@ -40,7 +39,14 @@ public class TrainingGroupController {
private final StudentService studentService;
private final TrainingSessionService trainingSessionService;
/**
* Constructor for TrainingGroupController.
*
* @param trainingGroupService Service for handling training group records.
* @param teacherService Service for handling teacher records.
* @param studentService Service for handling student records.
* @param trainingSessionService Service for handling training session records.
*/
public TrainingGroupController(TrainingGroupService trainingGroupService, TeacherService teacherService, StudentService studentService, TrainingSessionService trainingSessionService) {
this.trainingGroupService = trainingGroupService;
this.teacherService = teacherService;
@ -48,6 +54,12 @@ public class TrainingGroupController {
this.trainingSessionService = trainingSessionService;
}
/**
* Creates a new training group with a teacher.
*
* @param dto The TrainingGroupDTO containing the details of the group to be created.
* @return ResponseEntity containing the created TrainingGroupDTO.
*/
@Operation(summary = "Create a training group with a teacher")
@PostMapping("/create")
public ResponseEntity<TrainingGroupDTO> createGroup(@RequestBody TrainingGroupDTO dto) {
@ -68,7 +80,13 @@ public class TrainingGroupController {
return ResponseEntity.status(HttpStatus.CREATED).body(new TrainingGroupDTO(createdGroup));
}
/**
* Assigns a student to a training group.
*
* @param groupId The ID of the training group.
* @param studentId The ID of the student to be assigned.
* @return ResponseEntity indicating the result of the operation.
*/
@Operation(summary = "Assign a student to a group")
@PutMapping("/assign-student")
public ResponseEntity<Void> assignStudent(@RequestParam Integer groupId, @RequestParam Integer studentId) {
@ -79,6 +97,13 @@ public class TrainingGroupController {
return ResponseEntity.ok().build();
}
/**
* Removes a student from a training group.
*
* @param groupId The ID of the training group.
* @param studentId The ID of the student to be removed.
* @return ResponseEntity indicating the result of the operation.
*/
@Operation(summary = "Remove a student from a group")
@PutMapping("/remove-student")
public ResponseEntity<Void> removeStudent(@RequestParam Integer groupId, @RequestParam Integer studentId) {
@ -89,7 +114,14 @@ public class TrainingGroupController {
return ResponseEntity.ok().build();
}
@Operation(summary = "Actualizar un grupo de entrenamiento existente", description = "Actualiza un grupo de entrenamiento por su ID")
/**
* Updates an existing training group.
*
* @param id The ID of the training group to update.
* @param dto The TrainingGroupDTO containing the updated details of the group.
* @return ResponseEntity containing the updated TrainingGroupDTO.
*/
@Operation(summary = "Updates a training-group by its ID", description = "Update a training group with the specified ID")
@Transactional
@PutMapping("/update/{id}")
public ResponseEntity<TrainingGroupDTO> update(@PathVariable Integer id, @RequestBody TrainingGroupDTO dto) {
@ -113,13 +145,23 @@ public class TrainingGroupController {
return ResponseEntity.ok(new TrainingGroupDTO(updatedGroup));
}
/**
* Finds a training group by its ID.
*
* @param id The ID of the training group to retrieve.
* @return ResponseEntity containing the TrainingGroupDTO if found, or 404 Not Found if not found.
*/
@Operation(summary = "Find a training group by ID", description = "Retrieve a training group with the specified ID")
@GetMapping("findById/{id}")
public ResponseEntity<TrainingGroupDTO> findGroupById(@PathVariable Integer id) {
return ResponseEntity.ok(new TrainingGroupDTO(trainingGroupService.findById(id)));
}
/**
* Retrieves all training groups.
*
* @return ResponseEntity containing a list of TrainingGroupDTOs.
*/
@Operation(summary = "Get all training groups", description = "Retrieve a list of all training groups")
@GetMapping("/getAll")
public ResponseEntity<List<TrainingGroupDTO>> getAll() {
@ -130,13 +172,19 @@ public class TrainingGroupController {
);
}
/**
* Deletes a training group by its ID.
*
* @param id The ID of the training group to delete.
* @return ResponseEntity indicating the result of the deletion.
*/
@Operation(summary = "Delete a training group by ID", description = "Delete a training group with the specified ID")
@Transactional
@DeleteMapping("/delete/{id}")
public ResponseEntity<Void> delete(@PathVariable Integer id) {
TrainingGroup group = trainingGroupService.findById(id);
if (group == null) {
throw new EntityNotFoundException("Group not found");
throw new EntityNotFoundException("Training group not found with ID: " + id);
}
for (TrainingSession session : group.getTrainingSessions()) {
@ -162,6 +210,12 @@ public class TrainingGroupController {
return ResponseEntity.noContent().build();
}
/**
* Generates recurring training sessions for a group.
*
* @param dto The TrainingGroupDTO containing the group ID and recurrence details.
* @return ResponseEntity containing the updated TrainingGroupDTO.
*/
@Operation(summary = "Generate recurring training sessions for a group", description = "Generates recurring training sessions for a specified number of months")
@Transactional
@PostMapping("/generate-recurring-sessions")
@ -176,5 +230,4 @@ public class TrainingGroupController {
return ResponseEntity.ok(new TrainingGroupDTO(group));
}
}

26
memberflow-api/src/main/java/com/denniseckerskorn/controllers/class_management_controllers/TrainingSessionController.java
View File

@ -16,6 +16,10 @@ import java.time.LocalDateTime;
import java.util.List;
import java.util.stream.Collectors;
/**
* Controller for managing training sessions.
* Provides endpoints for creating, retrieving, and deleting training sessions.
*/
@RestController
@RequestMapping("/api/v1/training-sessions")
@Tag(name = "Training Session Management", description = "Operations related to training session management")
@ -23,17 +27,34 @@ public class TrainingSessionController {
private final TrainingSessionService trainingSessionService;
private final TrainingGroupService trainingGroupService;
/**
* Constructor for TrainingSessionController.
*
* @param trainingSessionService Service for handling training session records.
* @param trainingGroupService Service for handling training group records.
*/
public TrainingSessionController(TrainingSessionService trainingSessionService, TrainingGroupService trainingGroupService) {
this.trainingSessionService = trainingSessionService;
this.trainingGroupService = trainingGroupService;
}
/**
* Finds a training session by its ID and returns it as a DTO.
*
* @param id The ID of the training session to find.
* @return TrainingSessionDTO containing the details of the found training session.
*/
@Operation(summary = "Find a training session by ID", description = "Retrieve a training session by its ID")
@GetMapping("findById/{id}")
public TrainingSessionDTO findTrainingSessionById(@PathVariable Integer id) {
return TrainingSessionDTO.fromEntity(trainingSessionService.findById(id));
}
/**
* Gets all training sessions and returns them as a list of DTOs.
*
* @return List of TrainingSessionDTOs containing all training sessions.
*/
@Operation(summary = "Get all training sessions", description = "Retrieve a list of all training sessions")
@GetMapping("/getAll")
public List<TrainingSessionDTO> getAll() {
@ -43,6 +64,11 @@ public class TrainingSessionController {
.collect(Collectors.toList());
}
/**
* Gets all training sessions by group ID and returns them as a list of DTOs.
*
* @param id The ID of the training group to find sessions for.
*/
@Operation(summary = "Get all training sessions by group ID", description = "Retrieve a list of all training sessions by group ID")
@DeleteMapping("delete/{id}")
public void delete(@PathVariable Integer id) {

45
memberflow-api/src/main/java/com/denniseckerskorn/controllers/finance_management/IVATypeController.java
View File

@ -16,6 +16,10 @@ import org.springframework.web.bind.annotation.*;
import java.util.List;
import java.util.stream.Collectors;
/**
* Controller for managing IVA types.
* Provides endpoints for creating, retrieving, updating, and deleting IVA types.
*/
@RestController
@RequestMapping("/api/v1/iva-types")
@Tag(name = "IVA Types", description = "Operations related to IVA type management")
@ -23,10 +27,22 @@ public class IVATypeController {
private final IVATypeService ivaTypeService;
/**
* Constructor for IVATypeController.
*
* @param ivaTypeService Service for handling IVA type records.
*/
public IVATypeController(IVATypeService ivaTypeService) {
this.ivaTypeService = ivaTypeService;
}
/**
* Creates a new IVA type.
*
* @param dto The IVATypeDTO containing the details of the IVA type to be created.
* @return ResponseEntity containing the created IVATypeDTO.
* @throws DuplicateEntityException if an IVA type with the same name already exists.
*/
@PostMapping("/create")
@Operation(summary = "Create a new IVA type")
public ResponseEntity<IVATypeDTO> create(@Valid @RequestBody IVATypeDTO dto) throws DuplicateEntityException {
@ -34,6 +50,14 @@ public class IVATypeController {
return new ResponseEntity<>(new IVATypeDTO(saved), HttpStatus.CREATED);
}
/**
* Updates an existing IVA type.
*
* @param dto The IVATypeDTO containing the updated details of the IVA type.
* @return ResponseEntity containing the updated IVATypeDTO.
* @throws EntityNotFoundException if the IVA type to update does not exist.
* @throws InvalidDataException if the provided data is invalid.
*/
@PutMapping("/update")
@Operation(summary = "Update an existing IVA type")
public ResponseEntity<IVATypeDTO> update(@Valid @RequestBody IVATypeDTO dto) throws EntityNotFoundException, InvalidDataException {
@ -41,6 +65,14 @@ public class IVATypeController {
return new ResponseEntity<>(new IVATypeDTO(updated), HttpStatus.OK);
}
/**
* Retrieves an IVA type by its ID.
*
* @param id The ID of the IVA type to retrieve.
* @return ResponseEntity containing the IVATypeDTO if found.
* @throws EntityNotFoundException if the IVA type with the specified ID does not exist.
* @throws InvalidDataException if the provided ID is invalid.
*/
@GetMapping("/getById/{id}")
@Operation(summary = "Get IVA type by ID")
public ResponseEntity<IVATypeDTO> getById(@PathVariable Integer id) throws EntityNotFoundException, InvalidDataException {
@ -48,6 +80,11 @@ public class IVATypeController {
return new ResponseEntity<>(new IVATypeDTO(entity), HttpStatus.OK);
}
/**
* Retrieves all IVA types.
*
* @return ResponseEntity containing a list of IVATypeDTOs.
*/
@GetMapping("/getAll")
@Operation(summary = "Get all IVA types")
public ResponseEntity<List<IVATypeDTO>> getAll() {
@ -56,6 +93,14 @@ public class IVATypeController {
return new ResponseEntity<>(dtos, HttpStatus.OK);
}
/**
* Deletes an IVA type by its ID.
*
* @param id The ID of the IVA type to delete.
* @return ResponseEntity with no content if deletion is successful.
* @throws EntityNotFoundException if the IVA type with the specified ID does not exist.
* @throws InvalidDataException if the IVA type is in use and cannot be deleted.
*/
@DeleteMapping("/deleteById/{id}")
@Operation(summary = "Delete IVA type by ID (if not in use)")
public ResponseEntity<Void> delete(@PathVariable Integer id) throws EntityNotFoundException, InvalidDataException {

104
memberflow-api/src/main/java/com/denniseckerskorn/controllers/finance_management/InvoiceController.java
View File

@ -27,6 +27,10 @@ import org.springframework.web.bind.annotation.*;
import java.util.List;
import java.util.stream.Collectors;
/**
* Controller for managing invoices.
* Provides endpoints for creating, retrieving, updating, and deleting invoices,
*/
@RestController
@RequestMapping("/api/v1/invoices")
@Tag(name = "Invoices", description = "Operations related to invoice management")
@ -37,6 +41,14 @@ public class InvoiceController {
private final ProductServiceService productServiceService;
private final InvoicePdfGenerator invoicePdfGenerator;
/**
* Constructor for InvoiceController.
*
* @param invoiceService Service for handling invoice records.
* @param userService Service for handling user records.
* @param productServiceService Service for handling product/service records.
* @param invoicePdfGenerator Service for generating PDF invoices.
*/
public InvoiceController(InvoiceService invoiceService, UserService userService, ProductServiceService productServiceService, InvoicePdfGenerator invoicePdfGenerator) {
this.invoiceService = invoiceService;
this.userService = userService;
@ -44,6 +56,14 @@ public class InvoiceController {
this.invoicePdfGenerator = invoicePdfGenerator;
}
/**
* Creates a new invoice with lines.
*
* @param dto The CreateInvoiceRequestDTO containing the details of the invoice and its lines.
* @return ResponseEntity containing the created InvoiceDTO.
* @throws EntityNotFoundException If the user or product/service is not found.
* @throws InvalidDataException If the provided data is invalid.
*/
@PostMapping("/createInvoiceWithLines")
@Operation(summary = "Create a new invoice with lines")
public ResponseEntity<InvoiceDTO> createInvoiceWithLines(@Valid @RequestBody CreateInvoiceRequestDTO dto) throws EntityNotFoundException, InvalidDataException {
@ -59,7 +79,7 @@ public class InvoiceController {
for (CreateInvoiceLineDTO lineDTO : dto.getLines()) {
ProductService product = productServiceService.findById(lineDTO.getProductServiceId());
if (product == null) {
throw new EntityNotFoundException("Product/Service not found");
throw new EntityNotFoundException("Product/Service not found with ID: " + lineDTO.getProductServiceId());
}
InvoiceLine line = lineDTO.toEntity(invoice, product);
invoiceService.addLineToInvoiceById(invoice.getId(), line);
@ -69,6 +89,13 @@ public class InvoiceController {
return new ResponseEntity<>(new InvoiceDTO(invoice), HttpStatus.CREATED);
}
/**
* Generates a PDF for an invoice by its ID.
*
* @param id The ID of the invoice to generate the PDF for.
* @return ResponseEntity containing the PDF file as a byte array.
* @throws EntityNotFoundException If the invoice is not found.
*/
@GetMapping("/generatePDFById/{id}")
@Operation(summary = "Generate PDF for invoice by ID")
public ResponseEntity<byte[]> downloadInvoicePdf(@PathVariable Integer id) throws EntityNotFoundException {
@ -82,7 +109,13 @@ public class InvoiceController {
.body(pdf);
}
/**
* Creates a new invoice.
*
* @param dto The InvoiceDTO containing the details of the invoice to be created.
* @return ResponseEntity containing the created InvoiceDTO.
* @throws DuplicateEntityException If an invoice with the same details already exists.
*/
@PostMapping("/create")
@Operation(summary = "Create a new invoice")
public ResponseEntity<InvoiceDTO> createInvoice(@Valid @RequestBody InvoiceDTO dto) throws DuplicateEntityException {
@ -90,6 +123,14 @@ public class InvoiceController {
return new ResponseEntity<>(new InvoiceDTO(saved), HttpStatus.CREATED);
}
/**
* Updates an existing invoice.
*
* @param dto The InvoiceDTO containing the updated details of the invoice.
* @return ResponseEntity containing the updated InvoiceDTO.
* @throws EntityNotFoundException If the invoice to update is not found.
* @throws InvalidDataException If the provided data is invalid.
*/
@PutMapping("/update")
@Operation(summary = "Update an existing invoice")
public ResponseEntity<InvoiceDTO> updateInvoice(@Valid @RequestBody InvoiceDTO dto) throws EntityNotFoundException, InvalidDataException {
@ -97,6 +138,14 @@ public class InvoiceController {
return new ResponseEntity<>(new InvoiceDTO(updated), HttpStatus.OK);
}
/**
* Retrieves an invoice by its ID.
*
* @param id The ID of the invoice to retrieve.
* @return ResponseEntity containing the InvoiceDTO if found, or 404 Not Found if not found.
* @throws EntityNotFoundException If the invoice is not found.
* @throws InvalidDataException If the provided data is invalid.
*/
@GetMapping("/getById/{id}")
@Operation(summary = "Get invoice by ID")
public ResponseEntity<InvoiceDTO> getInvoiceById(@PathVariable Integer id) throws EntityNotFoundException, InvalidDataException {
@ -104,6 +153,11 @@ public class InvoiceController {
return new ResponseEntity<>(new InvoiceDTO(invoice), HttpStatus.OK);
}
/**
* Retrieves all invoices.
*
* @return ResponseEntity containing a list of InvoiceDTOs.
*/
@GetMapping("/getAll")
@Operation(summary = "Get all invoices")
public ResponseEntity<List<InvoiceDTO>> getAllInvoices() {
@ -112,6 +166,14 @@ public class InvoiceController {
return new ResponseEntity<>(dtos, HttpStatus.OK);
}
/**
* Deletes an invoice by its ID.
*
* @param id The ID of the invoice to delete.
* @return ResponseEntity with status NO_CONTENT if successful.
* @throws EntityNotFoundException If the invoice to delete is not found.
* @throws InvalidDataException If the provided data is invalid.
*/
@DeleteMapping("/deleteById/{id}")
@Operation(summary = "Delete invoice by ID")
public ResponseEntity<Void> deleteInvoice(@PathVariable Integer id) throws EntityNotFoundException, InvalidDataException {
@ -119,6 +181,13 @@ public class InvoiceController {
return new ResponseEntity<>(HttpStatus.NO_CONTENT);
}
/**
* Retrieves all invoices associated with a specific user ID.
*
* @param userId The ID of the user whose invoices are to be retrieved.
* @return ResponseEntity containing a list of InvoiceDTOs for the specified user.
* @throws InvalidDataException If the provided data is invalid.
*/
@GetMapping("/getAllInvoicesByUserId/{userId}")
@Operation(summary = "Get all invoices by user ID")
public ResponseEntity<List<InvoiceDTO>> getInvoicesByUserId(@PathVariable Integer userId) throws InvalidDataException {
@ -127,6 +196,13 @@ public class InvoiceController {
return new ResponseEntity<>(dtos, HttpStatus.OK);
}
/**
* Adds a line to an invoice by its ID.
*
* @param invoiceId The ID of the invoice to add the line to.
* @param line The InvoiceLine to be added to the invoice.
* @return ResponseEntity with status OK if successful.
*/
@PostMapping("/addLinesByInvoiceId/{invoiceId}")
@Operation(summary = "Add a line to an invoice by invoice ID")
public ResponseEntity<Void> addLineToInvoice(@PathVariable Integer invoiceId, @RequestBody @Valid InvoiceLine line) {
@ -134,6 +210,14 @@ public class InvoiceController {
return new ResponseEntity<>(HttpStatus.OK);
}
/**
* Removes a line from an invoice by its ID.
*
* @param invoiceId The ID of the invoice to remove the line from.
* @param lineId The ID of the line to be removed.
* @return ResponseEntity with status NO_CONTENT if successful.
* @throws EntityNotFoundException If the invoice or line is not found.
*/
@DeleteMapping("/removeLineFromInvoiceById/{invoiceId}")
@Operation(summary = "Remove a line from an invoice by IDs")
public ResponseEntity<Void> removeLineFromInvoice(@PathVariable Integer invoiceId, @PathVariable Integer lineId) {
@ -141,6 +225,14 @@ public class InvoiceController {
return new ResponseEntity<>(HttpStatus.NO_CONTENT);
}
/**
* Recalculates the total of an invoice by its ID.
*
* @param invoiceId The ID of the invoice to recalculate the total for.
* @return ResponseEntity with status OK if successful.
* @throws EntityNotFoundException If the invoice is not found.
* @throws InvalidDataException If the provided data is invalid.
*/
@PutMapping("/recalculateTotalOfInvoiceById/{invoiceId}")
@Operation(summary = "Recalculate the total of an invoice")
public ResponseEntity<Void> recalculateTotal(@PathVariable Integer invoiceId) throws EntityNotFoundException, InvalidDataException {
@ -149,6 +241,14 @@ public class InvoiceController {
return new ResponseEntity<>(HttpStatus.OK);
}
/**
* Clears all lines from an invoice by its ID.
*
* @param invoiceId The ID of the invoice to clear lines from.
* @return ResponseEntity with status NO_CONTENT if successful.
* @throws EntityNotFoundException If the invoice is not found.
* @throws InvalidDataException If the provided data is invalid.
*/
@DeleteMapping("/clearAllLinesFromInvoiceById/{invoiceId}")
@Operation(summary = "Clear all invoice lines from an invoice")
public ResponseEntity<Void> clearInvoiceLines(@PathVariable Integer invoiceId) throws EntityNotFoundException, InvalidDataException {

44
memberflow-api/src/main/java/com/denniseckerskorn/controllers/finance_management/InvoiceLineController.java
View File

@ -17,7 +17,8 @@ import java.util.List;
import java.util.stream.Collectors;
/**
* InvoiceLineController handles operations related to invoice lines (items in invoices).
* Controller for managing invoice lines.
* Provides endpoints for creating, retrieving, updating, and deleting invoice lines.
*/
@RestController
@RequestMapping("/api/v1/invoice-lines")
@ -26,10 +27,22 @@ public class InvoiceLineController {
private final InvoiceLineService invoiceLineService;
/**
* Constructor for InvoiceLineController.
*
* @param invoiceLineService Service for handling invoice line records.
*/
public InvoiceLineController(InvoiceLineService invoiceLineService) {
this.invoiceLineService = invoiceLineService;
}
/**
* Creates a new invoice line.
*
* @param dto The InvoiceLineDTO containing the details of the invoice line to be created.
* @return ResponseEntity containing the created InvoiceLineDTO.
* @throws DuplicateEntityException if an invoice line with the same details already exists.
*/
@PostMapping("/create")
@Operation(summary = "Create a new invoice line")
public ResponseEntity<InvoiceLineDTO> create(@Valid @RequestBody InvoiceLineDTO dto) throws DuplicateEntityException {
@ -37,6 +50,14 @@ public class InvoiceLineController {
return new ResponseEntity<>(new InvoiceLineDTO(saved), HttpStatus.CREATED);
}
/**
* Updates an existing invoice line.
*
* @param dto The InvoiceLineDTO containing the updated details of the invoice line.
* @return ResponseEntity containing the updated InvoiceLineDTO.
* @throws InvalidDataException if the provided data is invalid.
* @throws EntityNotFoundException if the invoice line to update does not exist.
*/
@PutMapping("/update")
@Operation(summary = "Update an existing invoice line")
public ResponseEntity<InvoiceLineDTO> update(@Valid @RequestBody InvoiceLineDTO dto) throws InvalidDataException, EntityNotFoundException {
@ -44,6 +65,14 @@ public class InvoiceLineController {
return new ResponseEntity<>(new InvoiceLineDTO(updated), HttpStatus.OK);
}
/**
* Retrieves an invoice line by its ID.
*
* @param id The ID of the invoice line to retrieve.
* @return ResponseEntity containing the InvoiceLineDTO of the found invoice line.
* @throws InvalidDataException if the provided ID is invalid.
* @throws EntityNotFoundException if the invoice line with the given ID does not exist.
*/
@GetMapping("/getById/{id}")
@Operation(summary = "Get invoice line by ID")
public ResponseEntity<InvoiceLineDTO> getById(@PathVariable Integer id) throws InvalidDataException, EntityNotFoundException {
@ -51,6 +80,11 @@ public class InvoiceLineController {
return new ResponseEntity<>(new InvoiceLineDTO(line), HttpStatus.OK);
}
/**
* Retrieves all invoice lines.
*
* @return ResponseEntity containing a list of InvoiceLineDTOs representing all invoice lines.
*/
@GetMapping("/getAll")
@Operation(summary = "Get all invoice lines")
public ResponseEntity<List<InvoiceLineDTO>> getAll() {
@ -59,6 +93,14 @@ public class InvoiceLineController {
return new ResponseEntity<>(dtos, HttpStatus.OK);
}
/**
* Deletes an invoice line by its ID.
*
* @param id The ID of the invoice line to delete.
* @return ResponseEntity with no content status.
* @throws InvalidDataException if the provided ID is invalid.
* @throws EntityNotFoundException if the invoice line with the given ID does not exist.
*/
@DeleteMapping("/deleteById/{id}")
@Operation(summary = "Delete invoice line by ID")
public ResponseEntity<Void> delete(@PathVariable Integer id) throws InvalidDataException, EntityNotFoundException {

56
memberflow-api/src/main/java/com/denniseckerskorn/controllers/finance_management/PaymentController.java
View File

@ -17,6 +17,10 @@ import org.springframework.web.bind.annotation.*;
import java.util.List;
import java.util.stream.Collectors;
/**
* PaymentController handles requests related to payment management.
* It provides endpoints for creating, updating, retrieving, and deleting payments.
*/
@RestController
@RequestMapping("/api/v1/payments")
@Tag(name = "Payments", description = "Operations related to payment management")
@ -24,10 +28,23 @@ public class PaymentController {
private final PaymentService paymentService;
/**
* Constructor for PaymentController.
*
* @param paymentService Service for handling payment records.
*/
public PaymentController(PaymentService paymentService) {
this.paymentService = paymentService;
}
/**
* Creates a new payment and marks the associated invoice as PAID.
*
* @param dto The PaymentDTO containing the details of the payment to be created.
* @return ResponseEntity containing the created PaymentDTO.
* @throws DuplicateEntityException if a payment already exists for the given invoice ID.
* @throws EntityNotFoundException if the invoice with the given ID does not exist.
*/
@PostMapping("/create")
@Operation(summary = "Create a new payment and mark invoice as PAID")
public ResponseEntity<PaymentDTO> create(@Valid @RequestBody PaymentDTO dto)
@ -46,7 +63,14 @@ public class PaymentController {
return new ResponseEntity<>(new PaymentDTO(saved), HttpStatus.CREATED);
}
/**
* Updates an existing payment and adjusts the invoice status accordingly.
*
* @param dto The PaymentDTO containing the updated details of the payment.
* @return ResponseEntity containing the updated PaymentDTO.
* @throws EntityNotFoundException if the invoice with the given ID does not exist.
* @throws InvalidDataException if the provided data is invalid.
*/
@PutMapping("/update")
@Operation(summary = "Update an existing payment and adjust invoice status")
public ResponseEntity<PaymentDTO> update(@Valid @RequestBody PaymentDTO dto)
@ -61,11 +85,18 @@ public class PaymentController {
if (updated == null) {
throw new InvalidDataException("Payment update failed for invoice ID: " + dto.getInvoiceId());
}
return new ResponseEntity<>(new PaymentDTO(updated), HttpStatus.OK);
}
/**
* Retrieves a payment by its ID.
*
* @param id The ID of the payment to retrieve.
* @return ResponseEntity containing the PaymentDTO if found.
* @throws EntityNotFoundException if the payment with the given ID does not exist.
* @throws InvalidDataException if the provided ID is invalid.
*/
@GetMapping("/getById/{id}")
@Operation(summary = "Get payment by ID")
public ResponseEntity<PaymentDTO> getById(@PathVariable Integer id) throws EntityNotFoundException, InvalidDataException {
@ -73,6 +104,11 @@ public class PaymentController {
return new ResponseEntity<>(new PaymentDTO(payment), HttpStatus.OK);
}
/**
* Retrieves all payments.
*
* @return ResponseEntity containing a list of PaymentDTOs.
*/
@GetMapping("/getAll")
@Operation(summary = "Get all payments")
public ResponseEntity<List<PaymentDTO>> getAll() {
@ -81,6 +117,14 @@ public class PaymentController {
return new ResponseEntity<>(dtos, HttpStatus.OK);
}
/**
* Deletes a payment by its ID and sets the associated invoice status to NOT_PAID.
*
* @param id The ID of the payment to delete.
* @return ResponseEntity with no content status.
* @throws EntityNotFoundException if the payment with the given ID does not exist.
* @throws InvalidDataException if the provided ID is invalid.
*/
@DeleteMapping("/deleteById/{id}")
@Operation(summary = "Remove a payment and set invoice status to NOT_PAID")
public ResponseEntity<Void> removePayment(@PathVariable Integer id) throws EntityNotFoundException, InvalidDataException {
@ -88,6 +132,12 @@ public class PaymentController {
return new ResponseEntity<>(HttpStatus.NO_CONTENT);
}
/**
* Retrieves all payments made by a specific user.
*
* @param userId The ID of the user whose payments are to be retrieved.
* @return ResponseEntity containing a list of PaymentDTOs for the specified user.
*/
@GetMapping("/getAllByUserId/{userId}")
@Operation(summary = "Get all payments by user ID")
public ResponseEntity<List<PaymentDTO>> getAllByUserId(@PathVariable Integer userId) {

47
memberflow-api/src/main/java/com/denniseckerskorn/controllers/finance_management/ProductServiceController.java
View File

@ -18,6 +18,10 @@ import org.springframework.web.bind.annotation.*;
import java.util.List;
import java.util.stream.Collectors;
/**
* Controller for managing products and services.
* Provides endpoints for creating, updating, retrieving, and deleting products/services.
*/
@RestController
@RequestMapping("/api/v1/products-services")
@Tag(name = "Product Services", description = "Operations related to product/service management")
@ -26,11 +30,24 @@ public class ProductServiceController {
private final ProductServiceService productServiceService;
private final IVATypeService ivaTypeService;
/**
* Constructor for ProductServiceController.
*
* @param productServiceService Service for handling product/service records.
* @param ivaTypeService Service for handling IVA type records.
*/
public ProductServiceController(ProductServiceService productServiceService, IVATypeService ivaTypeService) {
this.productServiceService = productServiceService;
this.ivaTypeService = ivaTypeService;
}
/**
* Creates a new product/service.
*
* @param dto The ProductServiceDTO containing the details of the product/service to be created.
* @return ResponseEntity containing the created ProductServiceDTO.
* @throws DuplicateEntityException if a product/service with the same name already exists.
*/
@PostMapping("/create")
@Operation(summary = "Create a new product/service")
public ResponseEntity<ProductServiceDTO> create(@Valid @RequestBody ProductServiceDTO dto) throws DuplicateEntityException {
@ -39,6 +56,14 @@ public class ProductServiceController {
return new ResponseEntity<>(new ProductServiceDTO(saved), HttpStatus.CREATED);
}
/**
* Updates an existing product/service.
*
* @param dto The ProductServiceDTO containing the updated details of the product/service.
* @return ResponseEntity containing the updated ProductServiceDTO.
* @throws EntityNotFoundException if the product/service to update does not exist.
* @throws InvalidDataException if the provided data is invalid.
*/
@PutMapping("/update")
@Operation(summary = "Update an existing product/service")
public ResponseEntity<ProductServiceDTO> update(@Valid @RequestBody ProductServiceDTO dto) throws EntityNotFoundException, InvalidDataException {
@ -47,7 +72,14 @@ public class ProductServiceController {
return new ResponseEntity<>(new ProductServiceDTO(updated), HttpStatus.OK);
}
/**
* Retrieves a product/service by its ID.
*
* @param id The ID of the product/service to retrieve.
* @return ResponseEntity containing the ProductServiceDTO if found.
* @throws EntityNotFoundException if the product/service with the specified ID does not exist.
* @throws InvalidDataException if the provided ID is invalid.
*/
@GetMapping("/getById/{id}")
@Operation(summary = "Get product/service by ID")
public ResponseEntity<ProductServiceDTO> getById(@PathVariable Integer id) throws EntityNotFoundException, InvalidDataException {
@ -55,6 +87,11 @@ public class ProductServiceController {
return new ResponseEntity<>(new ProductServiceDTO(entity), HttpStatus.OK);
}
/**
* Retrieves all products/services.
*
* @return ResponseEntity containing a list of ProductServiceDTOs.
*/
@GetMapping("/getAll")
@Operation(summary = "Get all products/services")
public ResponseEntity<List<ProductServiceDTO>> getAll() {
@ -63,6 +100,14 @@ public class ProductServiceController {
return new ResponseEntity<>(dtos, HttpStatus.OK);
}
/**
* Deletes a product/service by its ID.
*
* @param id The ID of the product/service to delete.
* @return ResponseEntity with no content if deletion is successful.
* @throws EntityNotFoundException if the product/service with the specified ID does not exist.
* @throws InvalidDataException if the provided ID is invalid.
*/
@DeleteMapping("/deleteById/{id}")
@Operation(summary = "Delete product/service by ID")
public ResponseEntity<Void> delete(@PathVariable Integer id) throws EntityNotFoundException, InvalidDataException {

60
memberflow-api/src/main/java/com/denniseckerskorn/controllers/user_managment_controllers/AdminController.java
View File

@ -18,6 +18,10 @@ import java.time.LocalDateTime;
import java.util.List;
import java.util.stream.Collectors;
/**
* Controller for managing administrators.
* Provides endpoints for creating, retrieving, updating, and deleting administrators.
*/
@RestController
@RequestMapping("/api/v1/admins")
@Tag(name = "Administrator Management", description = "Operations related to administrator management")
@ -26,14 +30,28 @@ public class AdminController {
private final AdminService adminService;
private final RoleService roleService;
/**
* Password encoder for encoding passwords.
*/
@Autowired
private PasswordEncoder passwordEncoder;
/**
* Constructor for AdminController.
*
* @param adminService Service for handling administrator records.
* @param roleService Service for handling roles.
*/
public AdminController(AdminService adminService, RoleService roleService) {
this.adminService = adminService;
this.roleService = roleService;
}
/**
* Gets all administrators and returns them as a list of DTOs.
*
* @return ResponseEntity containing a list of AdminDTOs or no content if none found.
*/
@Operation(summary = "Get all administrators")
@GetMapping("/getAll")
public ResponseEntity<List<AdminDTO>> getAllAdmins() {
@ -45,6 +63,12 @@ public class AdminController {
return dtos.isEmpty() ? ResponseEntity.noContent().build() : ResponseEntity.ok(dtos);
}
/**
* Gets administrator by ID and returns it as a DTO.
*
* @param id The ID of the administrator to find.
* @return ResponseEntity containing the AdminDTO or not found if the ID does not exist.
*/
@Operation(summary = "Get administrator by ID")
@GetMapping("/getById/{id}")
public ResponseEntity<AdminDTO> getById(@PathVariable Integer id) {
@ -52,6 +76,12 @@ public class AdminController {
return ResponseEntity.ok(convertToDTO(admin));
}
/**
* Creates a new administrator.
*
* @param dto The AdminDTO containing the details of the administrator to be created.
* @return ResponseEntity containing the created AdminDTO with status 201 Created.
*/
@Operation(summary = "Create a new administrator")
@PostMapping("/create")
public ResponseEntity<AdminDTO> create(@RequestBody AdminDTO dto) {
@ -60,6 +90,13 @@ public class AdminController {
return ResponseEntity.status(201).body(convertToDTO(saved));
}
/**
* Updates an existing administrator.
*
* @param id The ID of the administrator to update.
* @param dto The AdminDTO containing the updated details of the administrator.
* @return ResponseEntity containing the updated AdminDTO.
*/
@Operation(summary = "Update an existing administrator")
@PutMapping("/update/{id}")
public ResponseEntity<AdminDTO> update(@PathVariable Integer id, @RequestBody AdminDTO dto) {
@ -69,6 +106,12 @@ public class AdminController {
return ResponseEntity.ok(convertToDTO(updated));
}
/**
* Deletes an administrator by ID.
*
* @param id The ID of the administrator to delete.
* @return ResponseEntity with a message indicating successful deletion.
*/
@Operation(summary = "Delete an administrator by ID")
@DeleteMapping("/delete/{id}")
public ResponseEntity<String> delete(@PathVariable Integer id) {
@ -76,12 +119,26 @@ public class AdminController {
return ResponseEntity.ok("Admin deleted");
}
// -------------------- Utils --------------------
/* -------------------- Utils -------------------- */
/**
* Converts an Admin entity to an AdminDTO.
*
* @param admin The Admin entity to convert.
* @return The converted AdminDTO.
*/
private AdminDTO convertToDTO(Admin admin) {
return AdminDTO.fromEntity(admin);
}
/**
* Converts an AdminDTO to an Admin entity.
*
* @param dto The AdminDTO to convert.
* @param isCreate Indicates if the conversion is for creation (true) or update (false).
* @return The converted Admin entity.
* @throws InvalidDataException if the provided data is invalid.
*/
private Admin convertToEntity(AdminDTO dto, boolean isCreate) {
if (dto == null || dto.getUser() == null) {
throw new InvalidDataException("Admin and User data are required");
@ -118,5 +175,4 @@ public class AdminController {
admin.setUser(user);
return admin;
}
}

59
memberflow-api/src/main/java/com/denniseckerskorn/controllers/user_managment_controllers/NotificationController.java
View File

@ -15,6 +15,10 @@ import java.util.List;
import java.util.Set;
import java.util.stream.Collectors;
/**
* NotificationController handles requests related to notification management.
* It provides endpoints for creating, retrieving, updating, and deleting notifications.
*/
@RestController
@RequestMapping("/api/v1/notifications")
@Tag(name = "Notification Management", description = "Operations related to notifications")
@ -23,11 +27,22 @@ public class NotificationController {
private final NotificationService notificationService;
private final UserService userService;
/**
* Constructor for NotificationController.
*
* @param notificationService Service for handling notification records.
* @param userService Service for handling user records.
*/
public NotificationController(NotificationService notificationService, UserService userService) {
this.notificationService = notificationService;
this.userService = userService;
}
/**
* Gets all notifications and returns them as a list of DTOs.
*
* @return ResponseEntity containing a list of NotificationDTOs or no content if none found.
*/
@Operation(summary = "Get all notifications", description = "Retrieve a list of all notifications")
@GetMapping("/getAll")
public ResponseEntity<List<NotificationDTO>> getAll() {
@ -38,6 +53,12 @@ public class NotificationController {
return ResponseEntity.ok(dtos);
}
/**
* Gets a notification by its ID and returns it as a DTO.
*
* @param id The ID of the notification to find.
* @return ResponseEntity containing the NotificationDTO or not found if it doesn't exist.
*/
@Operation(summary = "Get a notification by ID", description = "Retrieve a notification by its ID")
@GetMapping("/getById/{id}")
public ResponseEntity<NotificationDTO> getById(@PathVariable Integer id) {
@ -45,6 +66,12 @@ public class NotificationController {
return ResponseEntity.ok(toDTO(notification));
}
/**
* Creates a new notification.
*
* @param dto The NotificationDTO containing the details of the notification to be created.
* @return ResponseEntity containing the created NotificationDTO.
*/
@Operation(summary = "Create a new notification", description = "Create a new notification")
@PostMapping("/create")
public ResponseEntity<NotificationDTO> create(@RequestBody NotificationDTO dto) {
@ -57,11 +84,16 @@ public class NotificationController {
notificationService.addNotificationToUser(saved, user);
}
}
return ResponseEntity.status(201).body(toDTO(saved));
}
/**
* Updates an existing notification by its ID.
*
* @param id The ID of the notification to update.
* @param dto The NotificationDTO containing the updated details of the notification.
* @return ResponseEntity containing the updated NotificationDTO.
*/
@Operation(summary = "Update a notification by ID", description = "Update a notification by its ID")
@PutMapping("/update/{id}")
public ResponseEntity<NotificationDTO> update(@PathVariable Integer id, @RequestBody NotificationDTO dto) {
@ -87,7 +119,12 @@ public class NotificationController {
return ResponseEntity.ok(toDTO(updated));
}
/**
* Deletes a notification by its ID.
*
* @param id The ID of the notification to delete.
* @return ResponseEntity with a message indicating successful deletion.
*/
@Operation(summary = "Delete a notification by ID", description = "Delete a notification by its ID")
@DeleteMapping("/delete/{id}")
public ResponseEntity<String> delete(@PathVariable Integer id) {
@ -95,8 +132,14 @@ public class NotificationController {
return ResponseEntity.ok("Notification deleted successfully.");
}
// -------------------- Mapping --------------------
/* -------------------- Utils -------------------- */
/**
* Converts a Notification entity to a NotificationDTO.
*
* @param notification The Notification entity to convert.
* @return The converted NotificationDTO.
*/
private NotificationDTO toDTO(Notification notification) {
Set<Integer> userIds = notification.getUsers() != null
? notification.getUsers().stream().map(User::getId).collect(Collectors.toSet())
@ -113,6 +156,13 @@ public class NotificationController {
);
}
/**
* Converts a NotificationDTO to a Notification entity.
*
* @param dto The NotificationDTO to convert.
* @param includeUsers Whether to include users in the conversion.
* @return The converted Notification entity.
*/
private Notification toEntity(NotificationDTO dto, boolean includeUsers) {
Notification notification = (dto.getId() != null)
? notificationService.findById(dto.getId())
@ -126,5 +176,4 @@ public class NotificationController {
return notification;
}
}

53
memberflow-api/src/main/java/com/denniseckerskorn/controllers/user_managment_controllers/PermissionController.java
View File

@ -11,6 +11,10 @@ import org.springframework.web.bind.annotation.*;
import java.util.List;
import java.util.stream.Collectors;
/**
* PermissionController handles requests related to permission management.
* It provides endpoints for creating, retrieving, updating, and deleting permissions.
*/
@RestController
@RequestMapping("/api/v1/permissions")
@Tag(name = "Permission Management", description = "Operations related to permissions")
@ -18,10 +22,20 @@ public class PermissionController {
private final PermissionService permissionService;
/**
* Constructor for PermissionController.
*
* @param permissionService Service for handling permission records.
*/
public PermissionController(PermissionService permissionService) {
this.permissionService = permissionService;
}
/**
* Retrieves all permissions and returns them as a list of DTOs.
*
* @return ResponseEntity containing a list of PermissionDTOs or no content if none found.
*/
@Operation(summary = "Get all permissions", description = "Retrieve a list of all permissions")
@GetMapping("/getAll")
public ResponseEntity<List<PermissionDTO>> getAll() {
@ -34,6 +48,12 @@ public class PermissionController {
return ResponseEntity.ok(dtos);
}
/**
* Retrieves a permission by its ID and returns it as a DTO.
*
* @param id The ID of the permission to find.
* @return ResponseEntity containing the PermissionDTO or not found if it doesn't exist.
*/
@Operation(summary = "Get permission by ID", description = "Retrieve a permission by its ID")
@GetMapping("/getById/{id}")
public ResponseEntity<PermissionDTO> getById(@PathVariable Integer id) {
@ -41,6 +61,12 @@ public class PermissionController {
return ResponseEntity.ok(toDTO(permission));
}
/**
* Creates a new permission and returns the created permission as a DTO.
*
* @param dto The PermissionDTO containing the details of the permission to be created.
* @return ResponseEntity containing the created PermissionDTO.
*/
@Operation(summary = "Create a new permission", description = "Create a new permission")
@PostMapping("/create")
public ResponseEntity<PermissionDTO> create(@RequestBody PermissionDTO dto) {
@ -49,6 +75,13 @@ public class PermissionController {
return ResponseEntity.status(201).body(toDTO(saved));
}
/**
* Updates an existing permission and returns the updated permission as a DTO.
*
* @param id The ID of the permission to update.
* @param dto The PermissionDTO containing the updated details of the permission.
* @return ResponseEntity containing the updated PermissionDTO.
*/
@Operation(summary = "Update an existing permission", description = "Update an existing permission")
@PutMapping("/update/{id}")
public ResponseEntity<PermissionDTO> update(@PathVariable Integer id, @RequestBody PermissionDTO dto) {
@ -57,6 +90,12 @@ public class PermissionController {
return ResponseEntity.ok(toDTO(updated));
}
/**
* Deletes a permission by its ID.
*
* @param id The ID of the permission to delete.
* @return ResponseEntity with a success message.
*/
@Operation(summary = "Delete a permission", description = "Delete a permission by its ID")
@DeleteMapping("/delete/{id}")
public ResponseEntity<String> delete(@PathVariable Integer id) {
@ -64,12 +103,24 @@ public class PermissionController {
return ResponseEntity.ok("Permission deleted successfully.");
}
// -------------------- Mapping --------------------
/* -------------------- Utils -------------------- */
/**
* Converts a Permission entity to a PermissionDTO.
*
* @param permission The Permission entity to convert.
* @return The converted PermissionDTO.
*/
private PermissionDTO toDTO(Permission permission) {
return new PermissionDTO(permission.getId(), permission.getPermissionName());
}
/**
* Converts a PermissionDTO to a Permission entity.
*
* @param dto The PermissionDTO to convert.
* @return The converted Permission entity.
*/
private Permission toEntity(PermissionDTO dto) {
Permission permission = (dto.getId() != null)
? permissionService.findById(dto.getId())

62
memberflow-api/src/main/java/com/denniseckerskorn/controllers/user_managment_controllers/RoleController.java
View File

@ -14,6 +14,10 @@ import java.util.List;
import java.util.Set;
import java.util.stream.Collectors;
/**
* RoleController handles requests related to role management.
* It provides endpoints for creating, retrieving, updating, and deleting roles.
*/
@RestController
@RequestMapping("/api/v1/roles")
@Tag(name = "Role Management", description = "Operations related to roles")
@ -22,11 +26,22 @@ public class RoleController {
private final RoleService roleService;
private final PermissionService permissionService;
/**
* Constructor for RoleController.
*
* @param roleService Service for handling role records.
* @param permissionService Service for handling permission records.
*/
public RoleController(RoleService roleService, PermissionService permissionService) {
this.roleService = roleService;
this.permissionService = permissionService;
}
/**
* Retrieves all roles and returns them as a list of DTOs.
*
* @return ResponseEntity containing a list of RoleDTOs or no content if none found.
*/
@Operation(summary = "Get all roles", description = "Retrieve a list of all roles")
@GetMapping("/getAll")
public ResponseEntity<List<RoleDTO>> getAll() {
@ -37,6 +52,12 @@ public class RoleController {
return ResponseEntity.ok(dtos);
}
/**
* Retrieves a role by its ID and returns it as a DTO.
*
* @param id The ID of the role to find.
* @return ResponseEntity containing the RoleDTO or not found if it doesn't exist.
*/
@Operation(summary = "Get role by ID", description = "Retrieve a role by its ID")
@GetMapping("/getById/{id}")
public ResponseEntity<RoleDTO> getById(@PathVariable Integer id) {
@ -44,6 +65,12 @@ public class RoleController {
return ResponseEntity.ok(toDTO(role));
}
/**
* Creates a new role and returns the created role as a DTO.
*
* @param dto The RoleDTO containing the details of the role to be created.
* @return ResponseEntity containing the created RoleDTO.
*/
@Operation(summary = "Create a new role", description = "Create a new role")
@PostMapping("/create")
public ResponseEntity<RoleDTO> create(@RequestBody RoleDTO dto) {
@ -61,6 +88,13 @@ public class RoleController {
return ResponseEntity.status(201).body(toDTO(saved));
}
/**
* Updates an existing role and returns the updated role as a DTO.
*
* @param id The ID of the role to update.
* @param dto The RoleDTO containing the updated details of the role.
* @return ResponseEntity containing the updated RoleDTO.
*/
@Operation(summary = "Update a role", description = "Update an existing role")
@PutMapping("/update/{id}")
public ResponseEntity<RoleDTO> update(@PathVariable Integer id, @RequestBody RoleDTO dto) {
@ -79,6 +113,12 @@ public class RoleController {
return ResponseEntity.ok(toDTO(updated));
}
/**
* Deletes a role by its ID.
*
* @param id The ID of the role to delete.
* @return ResponseEntity with a message indicating successful deletion.
*/
@Operation(summary = "Delete a role", description = "Delete a role by its ID")
@DeleteMapping("/delete/{id}")
public ResponseEntity<String> delete(@PathVariable Integer id) {
@ -86,6 +126,13 @@ public class RoleController {
return ResponseEntity.ok("Role deleted successfully.");
}
/**
* Adds a permission to a role.
*
* @param roleId The ID of the role to which the permission will be added.
* @param permissionId The ID of the permission to add to the role.
* @return ResponseEntity with a success message.
*/
@Operation(summary = "Add permission to role", description = "Add a permission to a role")
@PostMapping("/permissions/add/{roleId}/{permissionId}")
public ResponseEntity<String> addPermissionToRole(@PathVariable Integer roleId, @PathVariable Integer permissionId) {
@ -95,6 +142,13 @@ public class RoleController {
return ResponseEntity.ok("Permission added to role.");
}
/**
* Removes a permission from a role.
*
* @param roleId The ID of the role from which the permission will be removed.
* @param permissionId The ID of the permission to remove from the role.
* @return ResponseEntity with a success message.
*/
@Operation(summary = "Remove permission from role", description = "Remove a permission from a role")
@DeleteMapping("/permissions/remove/{permissionId}/{roleId}")
public ResponseEntity<String> removePermissionFromRole(@PathVariable Integer roleId, @PathVariable Integer permissionId) {
@ -104,8 +158,14 @@ public class RoleController {
return ResponseEntity.ok("Permission removed from role.");
}
// -------------------- Mapping --------------------
/* -------------------- Utils -------------------- */
/**
* Converts a Role entity to a RoleDTO.
*
* @param role The Role entity to convert.
* @return The converted RoleDTO.
*/
private RoleDTO toDTO(Role role) {
Set<Integer> permissionIds = role.getPermissions().stream()
.map(Permission::getId)

123
memberflow-api/src/main/java/com/denniseckerskorn/controllers/user_managment_controllers/StudentController.java
View File

@ -31,6 +31,10 @@ import java.time.LocalDateTime;
import java.util.List;
import java.util.stream.Collectors;
/**
* Controller for managing students.
* Provides endpoints for creating, retrieving, updating, and deleting students.
*/
@RestController
@RequestMapping("/api/v1/students")
@Tag(name = "Student Management", description = "Operations related to student management")
@ -42,9 +46,21 @@ public class StudentController {
private final MembershipService membershipService;
private final TrainingSessionService trainingSessionService;
/**
* Password encoder for encoding passwords.
*/
@Autowired
private PasswordEncoder passwordEncoder;
/**
* Constructor for StudentController.
*
* @param studentService Service for handling student records.
* @param roleService Service for handling roles.
* @param userService Service for handling user records.
* @param membershipService Service for handling membership records.
* @param trainingSessionService Service for handling training session records.
*/
public StudentController(StudentService studentService, RoleService roleService, UserService userService, MembershipService membershipService, TrainingSessionService trainingSessionService) {
this.studentService = studentService;
this.roleService = roleService;
@ -53,6 +69,12 @@ public class StudentController {
this.trainingSessionService = trainingSessionService;
}
/**
* Registers a new student with the provided details.
*
* @param studentRegisterDTO The DTO containing the student's registration details.
* @return ResponseEntity containing the created StudentDTO.
*/
@Operation(summary = "Register a new Student", description = "Registers a new student with the provided details.")
@PostMapping("/register")
public ResponseEntity<StudentDTO> registerStudent(@RequestBody @Valid StudentRegisterDTO studentRegisterDTO) {
@ -100,7 +122,11 @@ public class StudentController {
return ResponseEntity.status(HttpStatus.CREATED).body(response);
}
/**
* Retrieves all students.
*
* @return ResponseEntity containing a list of StudentDTOs.
*/
@Operation(summary = "Get all Students", description = "Retrieves a list of all students.")
@GetMapping("/getAll")
public ResponseEntity<List<StudentDTO>> getAllStudents() {
@ -114,6 +140,12 @@ public class StudentController {
return ResponseEntity.ok(dtos);
}
/**
* Creates a new student with the provided details.
*
* @param dto The StudentDTO containing the details of the student to be created.
* @return ResponseEntity containing the created StudentDTO.
*/
@Operation(summary = "Create a new Student", description = "Creates a new student with the provided details.")
@PostMapping("/create")
public ResponseEntity<StudentDTO> createStudent(@RequestBody StudentDTO dto) {
@ -122,6 +154,13 @@ public class StudentController {
return ResponseEntity.status(HttpStatus.CREATED).body(convertToDTO(saved));
}
/**
* Updates an existing student with the provided details.
*
* @param id The ID of the student to update.
* @param dto The StudentDTO containing the updated details of the student.
* @return ResponseEntity containing the updated StudentDTO.
*/
@Operation(summary = "Update an existing Student", description = "Updates the details of an existing student.")
@PutMapping("/update/{id}")
public ResponseEntity<StudentDTO> updateStudent(@PathVariable Integer id, @RequestBody StudentDTO dto) {
@ -131,6 +170,12 @@ public class StudentController {
return ResponseEntity.ok(convertToDTO(updated));
}
/**
* Retrieves a student by their ID.
*
* @param id The ID of the student to find.
* @return ResponseEntity containing the StudentDTO or not found if the ID does not exist.
*/
@Operation(summary = "Find a Student by ID", description = "Retrieves a student by their ID.")
@GetMapping("/findById/{id}")
public ResponseEntity<StudentDTO> getStudentById(@PathVariable Integer id) {
@ -138,6 +183,12 @@ public class StudentController {
return ResponseEntity.ok(convertToDTO(student));
}
/**
* Deletes a student by their ID.
*
* @param id The ID of the student to delete.
* @return ResponseEntity with a success message.
*/
@Operation(summary = "Delete a Student", description = "Deletes a student by their ID.")
@DeleteMapping("/delete/{id}")
public ResponseEntity<String> deleteStudent(@PathVariable Integer id) {
@ -145,6 +196,13 @@ public class StudentController {
return ResponseEntity.ok("Student deleted successfully");
}
/**
* Adds a history record to a student by their ID.
*
* @param id The ID of the student to whom the history will be added.
* @param history The StudentHistory object containing the history details to be added.
* @return ResponseEntity with a success message.
*/
@Operation(summary = "Add a Student History", description = "Adds a history record to a student by their ID.")
@PostMapping("/addStudentHistory/{id}")
public ResponseEntity<String> addStudentHistory(@PathVariable Integer id, @RequestBody StudentHistory history) {
@ -153,6 +211,12 @@ public class StudentController {
return ResponseEntity.ok("Student history added successfully");
}
/**
* Removes a history record from a student by their ID.
*
* @param id The ID of the history record to remove.
* @return ResponseEntity with a success message.
*/
@Operation(summary = "Remove a Student History", description = "Removes a history record from a student.")
@DeleteMapping("/removeStudentHistory/{id}")
public ResponseEntity<String> removeStudentHistory(@PathVariable Integer id) {
@ -160,6 +224,13 @@ public class StudentController {
return ResponseEntity.ok("Student history removed successfully");
}
/**
* Adds a membership to a student by their ID.
*
* @param id The ID of the student to whom the membership will be added.
* @param membership The Membership object containing the membership details to be added.
* @return ResponseEntity with a success message.
*/
@Operation(summary = "Add a Membership to a Student", description = "Adds a membership to a student by their ID.")
@PostMapping("/addMembershipToStudent/{id}")
public ResponseEntity<String> addMembershipToStudent(@PathVariable Integer id, @RequestBody Membership membership) {
@ -168,6 +239,12 @@ public class StudentController {
return ResponseEntity.ok("Membership added to student successfully");
}
/**
* Removes a membership from a student by their ID.
*
* @param id The ID of the student from whom the membership will be removed.
* @return ResponseEntity with a success message.
*/
@Operation(summary = "Remove a Membership from a Student", description = "Removes a membership from a student by their ID.")
@DeleteMapping("/removeMembershipFromStudent/{id}")
public ResponseEntity<String> removeMembershipFromStudent(@PathVariable Integer id) {
@ -175,6 +252,13 @@ public class StudentController {
return ResponseEntity.ok("Membership removed from student successfully");
}
/**
* Adds an assistance record to a student by their ID.
*
* @param id The ID of the student to whom the assistance will be added.
* @param assistanceDTO The AssistanceDTO containing the details of the assistance to be added.
* @return ResponseEntity with a success message.
*/
@Operation(summary = "Add an Assistance to a Student", description = "Adds an assistance record to a student by their ID.")
@PostMapping("/addAssistanceToStudent/{id}")
public ResponseEntity<String> addAssistanceToStudent(@PathVariable Integer id, @RequestBody AssistanceDTO assistanceDTO) {
@ -185,6 +269,13 @@ public class StudentController {
return ResponseEntity.ok("Assistance added to student successfully");
}
/**
* Removes an assistance record from a student by their ID.
*
* @param studentId The ID of the student from whom the assistance will be removed.
* @param assistanceId The ID of the assistance record to remove.
* @return ResponseEntity with a success message.
*/
@Operation(summary = "Remove an Assistance from a Student", description = "Removes an assistance record from a student by their ID.")
@DeleteMapping("/deleteAssistanceFromStudent/{id}")
public ResponseEntity<String> deleteAssistanceFromStudent(@PathVariable Integer studentId, @PathVariable Integer assistanceId) {
@ -192,6 +283,13 @@ public class StudentController {
return ResponseEntity.ok("Assistance removed from student successfully");
}
/**
* Adds a training group to a student by their ID.
*
* @param id The ID of the student to whom the training group will be added.
* @param group The TrainingGroup object containing the details of the group to be added.
* @return ResponseEntity with a success message.
*/
@Operation(summary = "Add a Training Group to a Student", description = "Adds a training group to a student by their ID.")
@PostMapping("/addGroupToStudent/{id}")
public ResponseEntity<String> addGroupToStudent(@PathVariable Integer id, @RequestBody TrainingGroup group) {
@ -199,6 +297,13 @@ public class StudentController {
return ResponseEntity.ok("Training group added to student successfully");
}
/**
* Updates a student's membership by their ID.
*
* @param studentId The ID of the student whose membership will be updated.
* @param membershipId The ID of the membership to assign to the student.
* @return ResponseEntity indicating the result of the operation.
*/
@Operation(summary = "Update a student's membership")
@PutMapping("/updateMembership/{studentId}")
public ResponseEntity<Void> updateMembership(
@ -216,13 +321,26 @@ public class StudentController {
/* ----------------- Mapping Methods ------------------ */
/* ----------------- Utils ------------------ */
/**
* Converts a Student entity to a StudentDTO.
*
* @param student The Student entity to convert.
* @return The converted StudentDTO.
*/
private StudentDTO convertToDTO(Student student) {
return StudentDTO.fromEntity(student);
}
/**
* Converts a StudentDTO to a Student entity.
*
* @param dto The StudentDTO to convert.
* @param isCreate Indicates if the conversion is for creating a new student.
* @return The converted Student entity.
*/
private Student convertToEntity(StudentDTO dto, boolean isCreate) {
if (dto == null || dto.getUser() == null) {
throw new InvalidDataException("User data is required");
@ -271,5 +389,4 @@ public class StudentController {
return student;
}
}

55
memberflow-api/src/main/java/com/denniseckerskorn/controllers/user_managment_controllers/StudentHistoryController.java
View File

@ -13,6 +13,10 @@ import org.springframework.web.bind.annotation.*;
import java.util.List;
import java.util.stream.Collectors;
/**
* StudentHistoryController handles requests related to student history management.
* It provides endpoints for creating, retrieving, updating, and deleting student histories.
*/
@RestController
@RequestMapping("/api/v1/student-history")
@Tag(name = "Student History Management", description = "Operations related to student history")
@ -21,11 +25,22 @@ public class StudentHistoryController {
private final StudentHistoryService studentHistoryService;
private final StudentService studentService;
/**
* Constructor for StudentHistoryController.
*
* @param studentHistoryService Service for handling student history records.
* @param studentService Service for handling student records.
*/
public StudentHistoryController(StudentHistoryService studentHistoryService, StudentService studentService) {
this.studentHistoryService = studentHistoryService;
this.studentService = studentService;
}
/**
* Retrieves all student histories and returns them as a list of DTOs.
*
* @return ResponseEntity containing a list of StudentHistoryDTOs or no content if none found.
*/
@Operation(summary = "Get all student histories", description = "Retrieve a list of all student histories")
@GetMapping("/getAll")
public ResponseEntity<List<StudentHistoryDTO>> getAll() {
@ -36,6 +51,12 @@ public class StudentHistoryController {
return ResponseEntity.ok(dtos);
}
/**
* Retrieves a student history by its ID and returns it as a DTO.
*
* @param id The ID of the student history to find.
* @return ResponseEntity containing the StudentHistoryDTO or not found if it doesn't exist.
*/
@Operation(summary = "find student history by ID", description = "Retrieve a student history by its ID")
@GetMapping("/findById/{id}")
public ResponseEntity<StudentHistoryDTO> findById(@PathVariable Integer id) {
@ -43,6 +64,12 @@ public class StudentHistoryController {
return ResponseEntity.ok(toDTO(history));
}
/**
* Creates a new student history and returns the created history as a DTO.
*
* @param dto The StudentHistoryDTO containing the details of the history to be created.
* @return ResponseEntity containing the created StudentHistoryDTO.
*/
@Operation(summary = "Create a new student history", description = "Create a new student history")
@PostMapping("/create")
public ResponseEntity<StudentHistoryDTO> create(@RequestBody StudentHistoryDTO dto) {
@ -51,6 +78,13 @@ public class StudentHistoryController {
return ResponseEntity.status(201).body(toDTO(saved));
}
/**
* Updates an existing student history and returns the updated history as a DTO.
*
* @param id The ID of the student history to update.
* @param dto The StudentHistoryDTO containing the updated details.
* @return ResponseEntity containing the updated StudentHistoryDTO.
*/
@Operation(summary = "Update an existing student history", description = "Update an existing student history")
@PutMapping("/update/{id}")
public ResponseEntity<StudentHistoryDTO> update(@PathVariable Integer id, @RequestBody StudentHistoryDTO dto) {
@ -60,6 +94,12 @@ public class StudentHistoryController {
return ResponseEntity.ok(toDTO(updated));
}
/**
* Deletes a student history by its ID.
*
* @param id The ID of the student history to delete.
* @return ResponseEntity with a success message.
*/
@Operation(summary = "Delete a student history", description = "Delete a student history by its ID")
@DeleteMapping("/delete/{id}")
public ResponseEntity<String> delete(@PathVariable Integer id) {
@ -67,8 +107,14 @@ public class StudentHistoryController {
return ResponseEntity.ok("Student history deleted successfully.");
}
// -------------------- Mapping --------------------
/* -------------------- Utils -------------------- */
/**
* Converts a StudentHistory entity to a StudentHistoryDTO.
*
* @param history The StudentHistory entity to convert.
* @return The converted StudentHistoryDTO.
*/
private StudentHistoryDTO toDTO(StudentHistory history) {
return new StudentHistoryDTO(
history.getId(),
@ -79,6 +125,13 @@ public class StudentHistoryController {
);
}
/**
* Converts a StudentHistoryDTO to a StudentHistory entity.
*
* @param dto The StudentHistoryDTO to convert.
* @param includeExistingStudent Whether to include the existing student in the history.
* @return The converted StudentHistory entity.
*/
private StudentHistory toEntity(StudentHistoryDTO dto, boolean includeExistingStudent) {
StudentHistory history = (dto.getId() != null)
? studentHistoryService.findById(dto.getId())

60
memberflow-api/src/main/java/com/denniseckerskorn/controllers/user_managment_controllers/TeacherController.java
View File

@ -18,6 +18,10 @@ import java.time.LocalDateTime;
import java.util.List;
import java.util.stream.Collectors;
/**
* Controller for managing teachers.
* Provides endpoints for creating, retrieving, updating, and deleting teachers.
*/
@RestController
@RequestMapping("/api/v1/teachers")
@Tag(name = "Teacher Management", description = "Operations related to teachers")
@ -26,14 +30,28 @@ public class TeacherController {
private final TeacherService teacherService;
private final RoleService roleService;
/**
* Password encoder for encoding passwords.
*/
@Autowired
private PasswordEncoder passwordEncoder;
/**
* Constructor for TeacherController.
*
* @param teacherService Service for handling teacher records.
* @param roleService Service for handling roles.
*/
public TeacherController(TeacherService teacherService, RoleService roleService) {
this.teacherService = teacherService;
this.roleService = roleService;
}
/**
* Gets all teachers and returns them as a list of DTOs.
*
* @return ResponseEntity containing a list of TeacherDTOs or no content if none found.
*/
@Operation(summary = "Get all teachers", description = "Retrieve a list of all teachers")
@GetMapping("/getAll")
public ResponseEntity<List<TeacherDTO>> getAllTeachers() {
@ -49,6 +67,12 @@ public class TeacherController {
return ResponseEntity.ok(dtos);
}
/**
* Creates a new teacher and returns the created teacher as a DTO.
*
* @param dto The TeacherDTO containing the details of the teacher to be created.
* @return ResponseEntity containing the created TeacherDTO.
*/
@Operation(summary = "Create a new teacher", description = "Create a new teacher")
@PostMapping("/create")
public ResponseEntity<TeacherDTO> createTeacher(@RequestBody TeacherDTO dto) {
@ -57,6 +81,12 @@ public class TeacherController {
return ResponseEntity.status(HttpStatus.CREATED).body(convertToDTO(saved));
}
/**
* Finds a teacher by their ID and returns it as a DTO.
*
* @param id The ID of the teacher to find.
* @return ResponseEntity containing the TeacherDTO or not found if it doesn't exist.
*/
@Operation(summary = "Find a teacher by ID", description = "Retrieve a teacher by their ID")
@GetMapping("/findById/{id}")
public ResponseEntity<TeacherDTO> findById(@PathVariable Integer id) {
@ -67,6 +97,13 @@ public class TeacherController {
return ResponseEntity.ok(convertToDTO(teacher));
}
/**
* Updates an existing teacher and returns the updated teacher as a DTO.
*
* @param id The ID of the teacher to update.
* @param dto The TeacherDTO containing the updated details of the teacher.
* @return ResponseEntity containing the updated TeacherDTO.
*/
@Operation(summary = "Update a teacher", description = "Update an existing teacher")
@PutMapping("/update/{id}")
public ResponseEntity<TeacherDTO> updateTeacher(@PathVariable Integer id, @RequestBody TeacherDTO dto) {
@ -76,7 +113,12 @@ public class TeacherController {
return ResponseEntity.ok(convertToDTO(updated));
}
/**
* Deletes a teacher by their ID.
*
* @param id The ID of the teacher to delete.
* @return ResponseEntity with a success message.
*/
@Operation(summary = "Delete a teacher", description = "Delete a teacher by their ID")
@DeleteMapping("/delete/{id}")
public ResponseEntity<String> deleteTeacher(@PathVariable Integer id) {
@ -84,12 +126,25 @@ public class TeacherController {
return ResponseEntity.ok("Teacher deleted successfully");
}
// ----------------- Mapping ------------------
/* ----------------- Utils ------------------ */
/**
* Converts a Teacher entity to a TeacherDTO.
*
* @param teacher The Teacher entity to convert.
* @return The converted TeacherDTO.
*/
private TeacherDTO convertToDTO(Teacher teacher) {
return TeacherDTO.fromEntity(teacher);
}
/**
* Converts a TeacherDTO to a Teacher entity.
*
* @param dto The TeacherDTO to convert.
* @param isCreate Indicates if this is a creation operation (true) or an update (false).
* @return The converted Teacher entity.
*/
private Teacher convertToEntity(TeacherDTO dto, boolean isCreate) {
if (dto == null || dto.getUser() == null) {
throw new InvalidDataException("User data is required");
@ -133,5 +188,4 @@ public class TeacherController {
return teacher;
}
}

79
memberflow-api/src/main/java/com/denniseckerskorn/controllers/user_managment_controllers/UserController.java
View File

@ -38,15 +38,30 @@ public class UserController {
private final RoleService roleService;
private final JwtUtil jwtUtil;
/**
* Password encoder for encoding passwords.
*/
@Autowired
private PasswordEncoder passwordEncoder;
/**
* Constructor for UserController.
*
* @param userService Service for handling user records.
* @param roleService Service for handling roles.
* @param jwtUtil Utility for JWT operations.
*/
public UserController(UserService userService, RoleService roleService, JwtUtil jwtUtil) {
this.userService = userService;
this.roleService = roleService;
this.jwtUtil = jwtUtil;
}
/**
* Gets all users and returns them as a list of DTOs.
*
* @return ResponseEntity containing a list of UserDTOs or no content if none found.
*/
@Operation(summary = "Get all users", description = "Retrieve a list of all users")
@GetMapping("/getAll")
public ResponseEntity<List<UserDTO>> getAllUsers() {
@ -62,6 +77,12 @@ public class UserController {
return ResponseEntity.ok(userDTOs);
}
/**
* Finds a user by their ID and returns it as a DTO.
*
* @param id The ID of the user to find.
* @return ResponseEntity containing the UserDTO or not found if the ID does not exist.
*/
@Operation(summary = "Find a User by ID", description = "Retrieve a user by their ID")
@GetMapping("/getById/{id}")
public ResponseEntity<UserDTO> getUserById(@PathVariable Integer id) {
@ -69,7 +90,13 @@ public class UserController {
return ResponseEntity.ok(convertToDTO(user));
}
@Operation( summary = "Find a User by email", description = "Retrieve a user by their email")
/**
* Creates a new user and returns the created user as a DTO.
*
* @param userDTO The UserDTO containing the details of the user to be created.
* @return ResponseEntity containing the created UserDTO with status 201 Created.
*/
@Operation(summary = "Create a new User", description = "Create a new user")
@PostMapping("/create")
public ResponseEntity<UserDTO> createUser(@RequestBody UserDTO userDTO) {
User user = convertToEntity(userDTO, true);
@ -77,6 +104,13 @@ public class UserController {
return ResponseEntity.status(HttpStatus.CREATED).body(convertToDTO(saved));
}
/**
* Updates an existing user by ID and returns the updated user as a DTO.
*
* @param id The ID of the user to update.
* @param userDTO The UserDTO containing the updated details of the user.
* @return ResponseEntity containing the updated UserDTO.
*/
@Operation(summary = "Update a user by ID", description = "Update an existing user")
@PutMapping("/update/{id}")
public ResponseEntity<UserDTO> updateUser(@PathVariable Integer id, @RequestBody UserDTO userDTO) {
@ -86,13 +120,25 @@ public class UserController {
return ResponseEntity.ok(convertToDTO(updated));
}
@Operation(summary = "Update a user by email", description = "Update an existing user")
/**
* Deletes a user by ID.
*
* @param id The ID of the user to delete.
* @return ResponseEntity with a success message.
*/
@Operation(summary = "Delete User by Id", description = "Delete a user by ID")
@DeleteMapping("/delete/{id}")
public ResponseEntity<String> deleteUser(@PathVariable Integer id) {
userService.deleteById(id);
return ResponseEntity.ok("User deleted successfully");
}
/**
* Retrieves the currently authenticated user based on the JWT token from the request.
*
* @param request The HTTP request containing the JWT token.
* @return ResponseEntity containing the UserDTO of the current user.
*/
@Operation(summary = "Get current user", description = "Retrieve the currently authenticated user")
@GetMapping("/me")
public ResponseEntity<UserDTO> getCurrentUser(HttpServletRequest request) {
@ -103,8 +149,15 @@ public class UserController {
return ResponseEntity.ok(convertToDTO(user));
}
// ------------------ UTILS ------------------
/* ------------------ UTILS ------------------ */
/**
* Extracts the JWT token from the Authorization header of the request.
*
* @param request The HTTP request containing the Authorization header.
* @return The extracted JWT token.
* @throws InvalidDataException if the Authorization header is missing or invalid.
*/
private String extractTokenFromRequest(HttpServletRequest request) {
String authHeader = request.getHeader("Authorization");
if (authHeader == null || !authHeader.startsWith("Bearer ")) {
@ -113,6 +166,12 @@ public class UserController {
return authHeader.substring(7); // Remove "Bearer "
}
/**
* Converts a User entity to a UserDTO.
*
* @param user The User entity to convert.
* @return The converted UserDTO.
*/
private UserDTO convertToDTO(User user) {
UserDTO dto = new UserDTO(
user.getId(),
@ -156,6 +215,12 @@ public class UserController {
return dto;
}
/**
* Converts a Notification entity to a NotificationMiniDTO.
*
* @param notification The Notification entity to convert.
* @return The converted NotificationMiniDTO.
*/
private NotificationMiniDTO convertNotificationToMiniDTO(Notification notification) {
return new NotificationMiniDTO(
notification.getId(),
@ -166,6 +231,14 @@ public class UserController {
);
}
/**
* Converts a UserDTO to a User entity.
*
* @param dto The UserDTO to convert.
* @param isCreate Indicates if the conversion is for creation (true) or update (false).
* @return The converted User entity.
* @throws InvalidDataException if the provided data is invalid.
*/
private User convertToEntity(UserDTO dto, boolean isCreate) {
User user;

1
memberflow-api/src/main/java/com/denniseckerskorn/dtos/class_managment_dtos/AssistanceDTO.java
View File

@ -1,6 +1,5 @@
package com.denniseckerskorn.dtos.class_managment_dtos;
import com.denniseckerskorn.entities.class_managment.Assistance;
import com.denniseckerskorn.entities.class_managment.TrainingSession;
import com.denniseckerskorn.entities.user_managment.users.Student;

4
memberflow-api/src/main/java/com/denniseckerskorn/dtos/finance_management_dtos/CreateInvoiceLineDTO.java
View File

@ -39,7 +39,6 @@ public class CreateInvoiceLineDTO {
this.unitPrice = unitPrice;
}
// Convierte a entidad con parámetros necesarios
public InvoiceLine toEntity(Invoice invoice, ProductService productService) {
InvoiceLine entity = new InvoiceLine();
entity.setInvoice(invoice);
@ -47,11 +46,10 @@ public class CreateInvoiceLineDTO {
entity.setQuantity(this.quantity);
entity.setUnitPrice(this.unitPrice);
entity.setSubtotal(this.unitPrice.multiply(BigDecimal.valueOf(this.quantity)));
entity.setDescription(productService.getName()); // opcional
entity.setDescription(productService.getName());
return entity;
}
// Convierte desde una entidad (opcional)
public static CreateInvoiceLineDTO fromEntity(InvoiceLine entity) {
CreateInvoiceLineDTO dto = new CreateInvoiceLineDTO();
dto.setProductServiceId(entity.getProductService() != null ? entity.getProductService().getId() : null);

4
memberflow-api/src/main/java/com/denniseckerskorn/dtos/finance_management_dtos/CreateInvoiceRequestDTO.java
View File

@ -20,8 +20,6 @@ public class CreateInvoiceRequestDTO {
public CreateInvoiceRequestDTO() {
}
// Getters y setters
public Integer getUserId() {
return userId;
}
@ -62,7 +60,6 @@ public class CreateInvoiceRequestDTO {
this.lines = lines;
}
// Convierte el DTO a entidad base (sin líneas, requiere setUser)
public Invoice toEntity(User user) {
Invoice invoice = new Invoice();
invoice.setUser(user);
@ -72,7 +69,6 @@ public class CreateInvoiceRequestDTO {
return invoice;
}
// Crea el DTO desde una entidad (opcional)
public static CreateInvoiceRequestDTO fromEntity(Invoice invoice) {
CreateInvoiceRequestDTO dto = new CreateInvoiceRequestDTO();
dto.setUserId(invoice.getUser() != null ? invoice.getUser().getId().intValue() : null);

6
memberflow-api/src/main/java/com/denniseckerskorn/dtos/finance_management_dtos/IVATypeDTO.java
View File

@ -14,7 +14,8 @@ public class IVATypeDTO {
private String description;
public IVATypeDTO() {}
public IVATypeDTO() {
}
public IVATypeDTO(IVAType entity) {
this.id = entity.getId();
@ -34,9 +35,6 @@ public class IVATypeDTO {
return iva;
}
// Getters y setters...
public Integer getId() {
return id;
}

3
memberflow-api/src/main/java/com/denniseckerskorn/dtos/finance_management_dtos/InvoiceDTO.java
View File

@ -63,9 +63,6 @@ public class InvoiceDTO {
return invoice;
}
// Getters y setters (puedes generarlos automáticamente)
public Integer getId() {
return id;
}

6
memberflow-api/src/main/java/com/denniseckerskorn/dtos/finance_management_dtos/InvoiceLineDTO.java
View File

@ -25,7 +25,8 @@ public class InvoiceLineDTO {
private BigDecimal subtotal;
public InvoiceLineDTO() {}
public InvoiceLineDTO() {
}
public InvoiceLineDTO(InvoiceLine entity) {
this.id = entity.getId();
@ -51,9 +52,6 @@ public class InvoiceLineDTO {
return entity;
}
// Getters y setters...
public Integer getId() {
return id;
}

4
memberflow-api/src/main/java/com/denniseckerskorn/dtos/finance_management_dtos/PaymentDTO.java
View File

@ -67,10 +67,6 @@ public class PaymentDTO {
return payment;
}
// Getters y setters...
public Integer getId() {
return id;
}

2
memberflow-api/src/main/java/com/denniseckerskorn/dtos/finance_management_dtos/ProductServiceDTO.java
View File

@ -70,8 +70,6 @@ public class ProductServiceDTO {
return entity;
}
// Getters y setters
public Integer getId() {
return id;
}

2
memberflow-api/src/main/java/com/denniseckerskorn/dtos/user_managment_dtos/AdminDTO.java
View File

@ -30,8 +30,6 @@ public class AdminDTO {
this.user = user;
}
// ------------ Métodos de conversión ------------
public static AdminDTO fromEntity(Admin admin) {
if (admin == null || admin.getUser() == null) {
return null;

3
memberflow-api/src/main/java/com/denniseckerskorn/dtos/user_managment_dtos/NotificationDTO.java
View File

@ -14,7 +14,8 @@ public class NotificationDTO {
private StatusValues status;
private Set<Integer> userIds;
public NotificationDTO() {}
public NotificationDTO() {
}
public NotificationDTO(Integer id, String title, String message, LocalDateTime shippingDate, String type, StatusValues status, Set<Integer> userIds) {
this.id = id;

1
memberflow-api/src/main/java/com/denniseckerskorn/dtos/user_managment_dtos/NotificationMiniDTO.java
View File

@ -20,7 +20,6 @@ public class NotificationMiniDTO {
this.type = type;
}
// Getters y setters
public Integer getId() {
return id;
}

2
memberflow-api/src/main/java/com/denniseckerskorn/dtos/user_managment_dtos/StudentDTO.java
View File

@ -109,8 +109,6 @@ public class StudentDTO {
return student;
}
// Getters y Setters...
public Integer getId() {
return id;
}

1
memberflow-api/src/main/java/com/denniseckerskorn/dtos/user_managment_dtos/StudentHistoryMiniDTO.java
View File

@ -18,7 +18,6 @@ public class StudentHistoryMiniDTO {
this.description = description;
}
// Getters y setters
public Integer getId() {
return id;
}

5
memberflow-api/src/main/java/com/denniseckerskorn/dtos/user_managment_dtos/StudentMiniDTO.java
View File

@ -4,9 +4,10 @@ import java.util.Set;
public class StudentMiniDTO {
private Integer id;
private Set<StudentHistoryMiniDTO> histories; // 🔥 mini DTO
private Set<StudentHistoryMiniDTO> histories;
public StudentMiniDTO() {}
public StudentMiniDTO() {
}
public Integer getId() {
return id;

40
memberflow-api/src/main/java/com/denniseckerskorn/dtos/user_managment_dtos/StudentRegisterDTO.java
View File

@ -1,21 +1,19 @@
package com.denniseckerskorn.dtos.user_managment_dtos;
import java.time.LocalDate;
import com.fasterxml.jackson.annotation.JsonFormat;
public class StudentRegisterDTO {
// Datos de usuario
private String name;
private String surname;
private String email;
private String password;
private String phoneNumber;
private String address;
private String roleName; // ejemplo: "ROLE_STUDENT"
private String status; // ejemplo: "ACTIVE"
private String roleName;
private String status;
// Datos de estudiante
private String dni;
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd")
@ -25,91 +23,117 @@ public class StudentRegisterDTO {
private String progress;
private String medicalReport;
private String parentName;
private Integer membershipId;
private Integer membershipId;
// --- Getters y Setters ---
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getSurname() {
return surname;
}
public void setSurname(String surname) {
this.surname = surname;
}
public String getEmail() {
return email;
}
public void setEmail(String email) {
this.email = email;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public String getPhoneNumber() {
return phoneNumber;
}
public void setPhoneNumber(String phoneNumber) {
this.phoneNumber = phoneNumber;
}
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
public String getRoleName() {
return roleName;
}
public void setRoleName(String roleName) {
this.roleName = roleName;
}
public String getStatus() {
return status;
}
public void setStatus(String status) {
this.status = status;
}
public String getDni() {
return dni;
}
public void setDni(String dni) {
this.dni = dni;
}
public LocalDate getBirthdate() {
return birthdate;
}
public void setBirthdate(LocalDate birthdate) {
this.birthdate = birthdate;
}
public String getBelt() {
return belt;
}
public void setBelt(String belt) {
this.belt = belt;
}
public String getProgress() {
return progress;
}
public void setProgress(String progress) {
this.progress = progress;
}
public String getMedicalReport() {
return medicalReport;
}
public void setMedicalReport(String medicalReport) {
this.medicalReport = medicalReport;
}
public String getParentName() {
return parentName;
}
public void setParentName(String parentName) {
this.parentName = parentName;
}
@ -117,9 +141,9 @@ public class StudentRegisterDTO {
public Integer getMembershipId() {
return membershipId;
}
public void setMembershipId(Integer membershipId) {
this.membershipId = membershipId;
}
}

5
memberflow-api/src/main/java/com/denniseckerskorn/dtos/user_managment_dtos/TeacherDTO.java
View File

@ -16,10 +16,7 @@ public class TeacherDTO {
this.user = user;
this.discipline = discipline;
}
// Getters y Setters
public Integer getId() {
return id;
}

5
memberflow-api/src/main/java/com/denniseckerskorn/dtos/user_managment_dtos/UserDTO.java
View File

@ -20,8 +20,6 @@ public class UserDTO {
private LocalDateTime registerDate;
private String roleName;
private StatusValues status;
// 🔥 Nuevos campos para el perfil completo
private Set<NotificationMiniDTO> notifications;
private StudentMiniDTO student;
@ -54,8 +52,6 @@ public class UserDTO {
this.status = user.getStatus();
}
// Getters y Setters
public Integer getId() {
return id;
}
@ -152,7 +148,6 @@ public class UserDTO {
this.student = student;
}
// Conversión (opcional)
public static UserDTO fromEntity(User user) {
if (user == null) return null;

4
memberflow-api/src/main/java/com/denniseckerskorn/exceptions/GlobalExceptionHandler.java
View File

@ -24,6 +24,10 @@ import org.springframework.web.servlet.resource.NoResourceFoundException;
import java.util.HashMap;
import java.util.Map;
/**
* GlobalExceptionHandler handles exceptions thrown by the application.
* It provides a centralized way to manage error responses for various exceptions.
*/
@ControllerAdvice
public class GlobalExceptionHandler {

14
memberflow-api/src/main/java/com/denniseckerskorn/services/finance_service/InvoicePdfGenerator.java
View File

@ -13,6 +13,10 @@ import org.springframework.stereotype.Service;
import java.io.ByteArrayOutputStream;
import java.math.BigDecimal;
/**
* InvoicePdfGenerator is a service that generates a PDF representation of an Invoice.
* It uses iText library to create the PDF document with invoice details.
*/
@Service
public class InvoicePdfGenerator {
@ -23,20 +27,20 @@ public class InvoicePdfGenerator {
PdfDocument pdf = new PdfDocument(writer);
Document doc = new Document(pdf);
// Cabecera
// Document title and metadata
doc.add(new Paragraph("FACTURA #" + invoice.getId()).setFontSize(16).setBold());
doc.add(new Paragraph("Fecha: " + invoice.getDate()));
doc.add(new Paragraph("Estado: " + invoice.getStatus()));
doc.add(new Paragraph(" "));
// Información del cliente
// Cliente information
var user = invoice.getUser();
doc.add(new Paragraph("Cliente: " + user.getName() + " " + user.getSurname()));
doc.add(new Paragraph("Email: " + user.getEmail()));
doc.add(new Paragraph("Teléfono: " + user.getPhoneNumber()));
doc.add(new Paragraph("Dirección: " + user.getAddress()));
// Si es estudiante, mostrar info básica (sin tutor ni cinturón)
// Student information
Student student = user.getStudent();
if (student != null) {
doc.add(new Paragraph("DNI: " + student.getDni()));
@ -45,7 +49,7 @@ public class InvoicePdfGenerator {
doc.add(new Paragraph(" "));
// Detalle de productos
// Products and services details
doc.add(new Paragraph("Detalle de productos:").setBold());
doc.add(new Paragraph("Producto | Cant. | Precio | IVA % | Subtotal (sin IVA) | IVA"));
@ -74,7 +78,7 @@ public class InvoicePdfGenerator {
));
}
// Totales
// Totals
doc.add(new Paragraph(" "));
doc.add(new Paragraph("Subtotal (sin IVA): " + totalSubtotal + " €").setBold());
doc.add(new Paragraph("IVA total: " + totalIVA + " €").setBold());

7
memberflow-api/src/main/resources/Checklist.txt
View File

@ -1,7 +0,0 @@
1. Comprobar seguridad y permisos en cada endpoint.
2. Comprobar o arreglar el tema de los ID automáticos y los DTOs.
3. Documentar los endpoints.
4. Crear javadoc de cada metodo.
5. Crear un README.md con la información del proyecto.
7. Comprobar como funciona logger en cada endpoint.
8. Mejorar excepciones y mensajes de error.

28
memberflow-data/src/main/java/com/denniseckerskorn/config/HibernateConfig.java
View File

@ -13,16 +13,31 @@ import org.springframework.transaction.annotation.EnableTransactionManagement;
import javax.sql.DataSource;
import java.util.Properties;
/**
* Hibernate configuration class for setting up the EntityManagerFactory and DataSource.
* It uses HikariCP for connection pooling and configures JPA properties.
*/
@Configuration
@EnableTransactionManagement
public class HibernateConfig {
private final Environment env;
/**
* Constructor to inject the Environment object for accessing properties.
*
* @param env the Environment object containing application properties
*/
public HibernateConfig(Environment env) {
this.env = env;
}
/**
* Bean definition for DataSource using HikariCP.
* Reads properties from the application environment.
*
* @return a configured DataSource instance
*/
@Bean
public DataSource dataSource() {
HikariDataSource dataSource = new HikariDataSource();
@ -33,6 +48,12 @@ public class HibernateConfig {
return dataSource;
}
/**
* Bean definition for LocalContainerEntityManagerFactoryBean.
*
* @param dataSource the DataSource to be used by the EntityManagerFactory
* @return a configured LocalContainerEntityManagerFactoryBean instance
*/
@Bean
public LocalContainerEntityManagerFactoryBean entityManagerFactory(DataSource dataSource) {
LocalContainerEntityManagerFactoryBean emf = new LocalContainerEntityManagerFactoryBean();
@ -50,6 +71,13 @@ public class HibernateConfig {
return emf;
}
/**
* Bean definition for PlatformTransactionManager.
* Uses JpaTransactionManager to manage transactions.
*
* @param emf the LocalContainerEntityManagerFactoryBean to be used by the transaction manager
* @return a configured PlatformTransactionManager instance
*/
@Bean
public PlatformTransactionManager transactionManager(LocalContainerEntityManagerFactoryBean emf) {
JpaTransactionManager transactionManager = new JpaTransactionManager();

5
memberflow-data/src/main/java/com/denniseckerskorn/repositories/class_managment_repositories/AssistanceRepository.java
View File

@ -8,6 +8,11 @@ import org.springframework.data.repository.query.Param;
import java.time.LocalDateTime;
import java.util.List;
/**
* Repository interface for managing Assistance entities.
* Provides methods to find assistance records by training session ID, student ID,
* and date range, as well as a method to find assistance by both training session ID and student ID.
*/
public interface AssistanceRepository extends JpaRepository<Assistance, Integer> {
Assistance findByTrainingSessionId(Integer trainingSessionId);

4
memberflow-data/src/main/java/com/denniseckerskorn/repositories/class_managment_repositories/MembershipRepository.java
View File

@ -8,6 +8,10 @@ import org.springframework.data.repository.query.Param;
import java.time.LocalDate;
/**
* Repository interface for managing Membership entities.
* Provides methods to find memberships by various attributes.
*/
public interface MembershipRepository extends JpaRepository<Membership, Integer> {
Membership findByType(MembershipTypeValues type);

4
memberflow-data/src/main/java/com/denniseckerskorn/repositories/class_managment_repositories/TrainingGroupRepository.java
View File

@ -3,5 +3,9 @@ package com.denniseckerskorn.repositories.class_managment_repositories;
import com.denniseckerskorn.entities.class_managment.TrainingGroup;
import org.springframework.data.jpa.repository.JpaRepository;
/**
* Repository interface for managing TrainingGroup entities.
* Provides methods to perform CRUD operations on TrainingGroup entities.
*/
public interface TrainingGroupRepository extends JpaRepository<TrainingGroup, Integer> {
}

4
memberflow-data/src/main/java/com/denniseckerskorn/repositories/class_managment_repositories/TrainingSessionRepository.java
View File

@ -7,6 +7,10 @@ import java.time.LocalDateTime;
import java.util.List;
/**
* Repository interface for managing TrainingSession entities.
* Provides methods to find training sessions by date and date range.
*/
public interface TrainingSessionRepository extends JpaRepository<TrainingSession, Integer> {
TrainingSession findByDate(LocalDateTime date);

4
memberflow-data/src/main/java/com/denniseckerskorn/repositories/finance_repositories/IVATypeRepository.java
View File

@ -5,6 +5,10 @@ import org.springframework.data.jpa.repository.JpaRepository;
import java.math.BigDecimal;
/**
* Repository interface for managing IVAType entities.
* Provides methods to perform CRUD operations on IVAType entities.
*/
public interface IVATypeRepository extends JpaRepository<IVAType, Integer> {
boolean existsByPercentage(BigDecimal percentage);

4
memberflow-data/src/main/java/com/denniseckerskorn/repositories/finance_repositories/InvoiceLineRepository.java
View File

@ -3,5 +3,9 @@ package com.denniseckerskorn.repositories.finance_repositories;
import com.denniseckerskorn.entities.finance.InvoiceLine;
import org.springframework.data.jpa.repository.JpaRepository;
/**
* Repository interface for managing InvoiceLine entities.
* Provides methods to perform CRUD operations on InvoiceLine entities.
*/
public interface InvoiceLineRepository extends JpaRepository<InvoiceLine, Integer> {
}

4
memberflow-data/src/main/java/com/denniseckerskorn/repositories/finance_repositories/InvoiceRepository.java
View File

@ -3,5 +3,9 @@ package com.denniseckerskorn.repositories.finance_repositories;
import com.denniseckerskorn.entities.finance.Invoice;
import org.springframework.data.jpa.repository.JpaRepository;
/**
* Repository interface for managing Invoice entities.
* Provides methods to perform CRUD operations on Invoice entities.
*/
public interface InvoiceRepository extends JpaRepository<Invoice, Integer> {
}

4
memberflow-data/src/main/java/com/denniseckerskorn/repositories/finance_repositories/PaymentRepository.java
View File

@ -5,6 +5,10 @@ import com.denniseckerskorn.entities.finance.Payment;
import org.springframework.data.jpa.repository.JpaRepository;
import java.util.List;
/**
* Repository interface for managing Payment entities.
* Provides methods to check if a payment exists by invoice ID and to find payments by user ID.
*/
public interface PaymentRepository extends JpaRepository<Payment, Integer> {
boolean existsByInvoiceId(Integer invoiceId);

4
memberflow-data/src/main/java/com/denniseckerskorn/repositories/finance_repositories/ProductServiceRepository.java
View File

@ -3,6 +3,10 @@ package com.denniseckerskorn.repositories.finance_repositories;
import com.denniseckerskorn.entities.finance.ProductService;
import org.springframework.data.jpa.repository.JpaRepository;
/**
* Repository interface for managing ProductService entities.
* Provides methods to perform CRUD operations on ProductService entities.
*/
public interface ProductServiceRepository extends JpaRepository<ProductService, Integer> {
boolean existsByName(String name);

4
memberflow-data/src/main/java/com/denniseckerskorn/repositories/user_managment_repositories/AdminRepository.java
View File

@ -3,6 +3,10 @@ package com.denniseckerskorn.repositories.user_managment_repositories;
import com.denniseckerskorn.entities.user_managment.users.Admin;
import org.springframework.data.jpa.repository.JpaRepository;
/**
* Repository interface for managing Admin entities.
* Provides methods to perform CRUD operations on Admin entities.
*/
public interface AdminRepository extends JpaRepository<Admin, Integer> {
boolean existsByUserEmail(String email);

5
memberflow-data/src/main/java/com/denniseckerskorn/repositories/user_managment_repositories/NotificationRepository.java
View File

@ -6,6 +6,11 @@ import org.springframework.data.jpa.repository.JpaRepository;
import java.time.LocalDateTime;
import java.util.List;
/**
* Repository interface for managing Notification entities.
* Provides methods to check if a notification exists by title and shipping date,
* and to find notifications by their ID.
*/
public interface NotificationRepository extends JpaRepository<Notification, Integer> {
boolean existsByTitleAndShippingDate(String title, LocalDateTime shippingDate);
List<Notification> findNotificationsById(Integer id);

4
memberflow-data/src/main/java/com/denniseckerskorn/repositories/user_managment_repositories/PermissionRepository.java
View File

@ -4,6 +4,10 @@ import com.denniseckerskorn.entities.user_managment.Permission;
import com.denniseckerskorn.enums.PermissionValues;
import org.springframework.data.jpa.repository.JpaRepository;
/**
* Repository interface for managing Permission entities.
* Provides methods to perform CRUD operations on Permission entities.
*/
public interface PermissionRepository extends JpaRepository<Permission, Integer> {
Permission findByPermissionName(PermissionValues permissionName);
boolean existsByPermissionName(PermissionValues permissionName);

4
memberflow-data/src/main/java/com/denniseckerskorn/repositories/user_managment_repositories/RoleRepository.java
View File

@ -3,6 +3,10 @@ package com.denniseckerskorn.repositories.user_managment_repositories;
import com.denniseckerskorn.entities.user_managment.Role;
import org.springframework.data.jpa.repository.JpaRepository;
/**
* Repository interface for managing Role entities.
* Provides methods to perform CRUD operations on Role entities.
*/
public interface RoleRepository extends JpaRepository<Role, Integer> {
Role findByName(String name);
}

4
memberflow-data/src/main/java/com/denniseckerskorn/repositories/user_managment_repositories/StudentHistoryRepository.java
View File

@ -3,6 +3,10 @@ package com.denniseckerskorn.repositories.user_managment_repositories;
import com.denniseckerskorn.entities.user_managment.StudentHistory;
import org.springframework.data.jpa.repository.JpaRepository;
/**
* Repository interface for managing StudentHistory entities.
* Provides methods to perform CRUD operations on StudentHistory entities.
*/
public interface StudentHistoryRepository extends JpaRepository<StudentHistory, Integer> {
boolean existsByEventType(String eventType);

4
memberflow-data/src/main/java/com/denniseckerskorn/repositories/user_managment_repositories/StudentRepository.java
View File

@ -3,6 +3,10 @@ package com.denniseckerskorn.repositories.user_managment_repositories;
import com.denniseckerskorn.entities.user_managment.users.Student;
import org.springframework.data.jpa.repository.JpaRepository;
/**
* Repository interface for managing Student entities.
* Provides methods to perform CRUD operations on Student entities.
*/
public interface StudentRepository extends JpaRepository<Student, Integer> {
boolean existsByDni(String dni);
Student findByDni(String dni);

4
memberflow-data/src/main/java/com/denniseckerskorn/repositories/user_managment_repositories/TeacherRepository.java
View File

@ -3,6 +3,10 @@ package com.denniseckerskorn.repositories.user_managment_repositories;
import com.denniseckerskorn.entities.user_managment.users.Teacher;
import org.springframework.data.jpa.repository.JpaRepository;
/**
* Repository interface for managing Teacher entities.
* Provides methods to perform CRUD operations on Teacher entities.
*/
public interface TeacherRepository extends JpaRepository<Teacher, Integer> {
boolean existsByUserEmail(String mail);

5
memberflow-data/src/main/java/com/denniseckerskorn/repositories/user_managment_repositories/UserRepository.java
View File

@ -6,6 +6,11 @@ import org.springframework.data.jpa.repository.JpaRepository;
import java.util.List;
/**
* Repository interface for managing User entities.
* Provides methods to check if a user exists by email, find a user by email,
* and retrieve all users with a specific role.
*/
public interface UserRepository extends JpaRepository<User, Integer> {
boolean existsByEmail(String email);

78
memberflow-data/src/main/java/com/denniseckerskorn/seeder/TestDataSeeder.java
View File

@ -33,6 +33,12 @@ import java.math.BigDecimal;
import java.time.LocalDate;
import java.time.LocalDateTime;
/**
* TestDataSeeder is a component that seeds the database with initial test data
* when the application starts in the "dev" profile.
* It creates roles, permissions, users, memberships, training groups, sessions,
* and other entities to facilitate development and testing.
*/
@Component
@Profile("dev")
public class TestDataSeeder implements CommandLineRunner {
@ -58,7 +64,27 @@ public class TestDataSeeder implements CommandLineRunner {
private final ProductServiceService productServiceService;
private final PaymentService paymentService;
/**
* Constructor for TestDataSeeder.
*
* @param adminService Service for managing admin entities.
* @param notificationService Service for managing notifications.
* @param permissionService Service for managing permissions.
* @param roleService Service for managing roles.
* @param studentHistoryService Service for managing student history.
* @param studentService Service for managing student entities.
* @param teacherService Service for managing teacher entities.
* @param userService Service for managing user entities.
* @param membershipService Service for managing memberships.
* @param assistanceService Service for managing assistance records.
* @param trainingGroupService Service for managing training groups.
* @param trainingSessionService Service for managing training sessions.
* @param invoiceService Service for managing invoices.
* @param invoiceLineService Service for managing invoice lines.
* @param ivaTypeService Service for managing IVA types.
* @param productServiceService Service for managing product/services.
* @param paymentService Service for managing payments.
*/
@Autowired
public TestDataSeeder(AdminService adminService,
NotificationService notificationService,
@ -96,6 +122,14 @@ public class TestDataSeeder implements CommandLineRunner {
this.paymentService = paymentService;
}
/**
* This method is executed when the application starts.
* It seeds the database with initial data for roles, permissions, users,
* memberships, training groups, sessions, and other entities.
*
* @param args command line arguments
* @throws Exception if an error occurs during seeding
*/
@Override
public void run(String... args) throws Exception {
// Roles
@ -111,32 +145,30 @@ public class TestDataSeeder implements CommandLineRunner {
adminRole.setName("ROLE_ADMIN");
this.roleService.save(adminRole);
// Permisos
// Permissions
for (PermissionValues value : PermissionValues.values()) {
Permission p = new Permission();
p.setPermissionName(value);
this.permissionService.save(p);
}
// Obtener permisos de la base de datos
// Obtain permissions
Permission fullAccess = this.permissionService.findPermissionByName(PermissionValues.FULL_ACCESS);
Permission manageUsers = this.permissionService.findPermissionByName(PermissionValues.MANAGE_STUDENTS);
Permission viewOwnData = this.permissionService.findPermissionByName(PermissionValues.VIEW_OWN_DATA);
// Asignar permisos a roles
// Assign permissions to roles
studentRole.addPermission(viewOwnData);
teacherRole.addPermission(manageUsers);
teacherRole.addPermission(viewOwnData);
adminRole.addPermission(fullAccess);
// Guardar roles actualizados
// Update roles with permissions
this.roleService.update(studentRole);
this.roleService.update(teacherRole);
this.roleService.update(adminRole);
// Membresías
// Memberships
Membership basicMembership = new Membership();
basicMembership.setType(MembershipTypeValues.BASIC);
basicMembership.setStartDate(LocalDate.now());
@ -165,7 +197,7 @@ public class TestDataSeeder implements CommandLineRunner {
noLimitMembership.setStatus(StatusValues.ACTIVE);
this.membershipService.save(noLimitMembership);
// Usuarios
// Users and their roles
User studentUser = new User();
studentUser.setName("Student");
studentUser.setSurname("One");
@ -178,7 +210,6 @@ public class TestDataSeeder implements CommandLineRunner {
studentUser.setRole(studentRole);
this.userService.save(studentUser);
Student student = new Student();
student.setUser(studentUser);
student.setBirthdate(LocalDate.of(2005, 5, 20));
@ -210,7 +241,6 @@ public class TestDataSeeder implements CommandLineRunner {
teacherUser.setRole(teacherRole);
this.userService.save(teacherUser);
Teacher teacher = new Teacher();
teacher.setUser(teacherUser);
teacher.setDiscipline("Jiu-Jitsu");
@ -228,7 +258,6 @@ public class TestDataSeeder implements CommandLineRunner {
adminUser.setRole(adminRole);
this.userService.save(adminUser);
Admin admin = new Admin();
admin.setUser(adminUser);
this.adminService.save(admin);
@ -246,32 +275,31 @@ public class TestDataSeeder implements CommandLineRunner {
notification.addUser(adminUser);
this.notificationService.update(notification);
// Grupo de entrenamiento
// Create a training group
TrainingGroup trainingGroup = new TrainingGroup();
trainingGroup.setName("Grupo JiuJitsu Avanzado");
trainingGroup.setSchedule(LocalDateTime.now().plusDays(1));
trainingGroup.setTeacher(teacher);
this.trainingGroupService.save(trainingGroup);
// Asignar grupo al estudiante
// Assign the training group to the student
this.studentService.addGroupToStudent(student.getId(), trainingGroup);
// Sesión de entrenamiento
// Create a training session
TrainingSession trainingSession = new TrainingSession();
trainingSession.setTrainingGroup(trainingGroup);
trainingSession.setDate(LocalDateTime.now().plusDays(2));
trainingSession.setStatus(StatusValues.ACTIVE);
this.trainingSessionService.save(trainingSession);
// Crear asistencia con sesión válida
// Add the training session to the group
Assistance validAssistance = new Assistance();
validAssistance.setDate(LocalDateTime.now());
validAssistance.setStudent(student);
validAssistance.setTrainingSession(trainingSession);
this.studentService.addAssistanceToStudent(student, validAssistance);
// Factura para el estudiante
// Create an invalid assistance
Invoice invoice = new Invoice();
invoice.setUser(studentUser);
invoice.setDate(LocalDateTime.now().minusDays(1));
@ -280,13 +308,13 @@ public class TestDataSeeder implements CommandLineRunner {
this.invoiceService.save(invoice);
this.userService.addInvoiceToUser(studentUser, invoice);
// IVA TYPE
// Create an IVA type
IVAType ivaGeneral = new IVAType();
ivaGeneral.setPercentage(new BigDecimal("21.00"));
ivaGeneral.setDescription("IVA General");
this.ivaTypeService.save(ivaGeneral);
// PRODUCTO / SERVICIO
// Create a product/service
ProductService jiuJitsuClass = new ProductService();
jiuJitsuClass.setName("Clase de JiuJitsu");
jiuJitsuClass.setType("Servicio");
@ -295,7 +323,7 @@ public class TestDataSeeder implements CommandLineRunner {
jiuJitsuClass.setStatus(StatusValues.ACTIVE);
this.productServiceService.save(jiuJitsuClass);
// LÍNEA DE FACTURA
// Add the product/service to the invoice
InvoiceLine line = new InvoiceLine();
line.setInvoice(invoice);
line.setProductService(jiuJitsuClass);
@ -304,18 +332,16 @@ public class TestDataSeeder implements CommandLineRunner {
line.setSubtotal(jiuJitsuClass.getPrice().multiply(BigDecimal.valueOf(line.getQuantity())));
this.invoiceService.addLineToInvoice(invoice, line);
// PAGO (PAYMENT)
// Calculate the total with IVA
Payment payment = new Payment();
payment.setInvoice(invoice);
payment.setAmount(invoice.getTotal()); // Debe incluir el IVA si se calcula externamente
payment.setAmount(invoice.getTotal());
payment.setPaymentMethod(PaymentMethodValues.CREDIT_CARD);
payment.setPaymentDate(LocalDateTime.now());
payment.setStatus(StatusValues.PAID);
this.paymentService.save(payment);
// Mostrar todo
// Show all data in the console
System.out.println("--- ROLES ---");
this.roleService.findAll().forEach(System.out::println);

54
memberflow-data/src/main/java/com/denniseckerskorn/services/class_managment_services/AssistanceService.java
View File

@ -23,15 +23,23 @@ public class AssistanceService extends AbstractService<Assistance, Integer> {
private final AssistanceRepository assistanceRepository;
/**
* Constructor for AssitanceService.
* Constructor for AssistanceService.
*
* @param assistanceRepository the assistance repository
* @param assistanceRepository the repository for assistance records
*/
public AssistanceService(AssistanceRepository assistanceRepository) {
super(assistanceRepository);
this.assistanceRepository = assistanceRepository;
}
/**
* Creates a new Assistance entity with the current date and time.
*
* @param entity the assistance to create
* @return the created assistance entity
* @throws IllegalArgumentException if the assistance is null
* @throws DuplicateEntityException if the assistance already exists
*/
@Override
public Assistance save(Assistance entity) throws IllegalArgumentException, DuplicateEntityException {
logger.info("Saving assistance: {}", entity);
@ -42,6 +50,15 @@ public class AssistanceService extends AbstractService<Assistance, Integer> {
return super.save(entity);
}
/**
* Updates an existing Assistance entity.
*
* @param entity the entity to update
* @return the updated assistance entity
* @throws IllegalArgumentException if the assistance is null
* @throws InvalidDataException if the assistance data is invalid
* @throws EntityNotFoundException if the assistance does not exist
*/
@Override
public Assistance update(Assistance entity) throws IllegalArgumentException, InvalidDataException, EntityNotFoundException {
logger.info("Updating assistance: {}", entity);
@ -49,11 +66,26 @@ public class AssistanceService extends AbstractService<Assistance, Integer> {
return super.update(entity);
}
/**
* Gets the ID of the Assistance entity.
*
* @param entity the assistance entity
* @return the ID of the assistance entity
* @throws IllegalStateException if the entity does not have an ID
*/
@Override
protected Integer getEntityId(Assistance entity) throws IllegalStateException {
return super.getEntityId(entity);
}
/**
* Finds an Assistance entity by its ID.
*
* @param id the ID of the assistance
* @return the found assistance entity
* @throws InvalidDataException if the ID is null
* @throws EntityNotFoundException if the assistance does not exist
*/
@Override
public Assistance findById(Integer id) throws InvalidDataException, EntityNotFoundException {
logger.info("Finding assistance by ID: {}", id);
@ -64,6 +96,13 @@ public class AssistanceService extends AbstractService<Assistance, Integer> {
return super.findById(id);
}
/**
* Deletes an Assistance entity by its ID.
*
* @param id the ID of the assistance to delete
* @throws InvalidDataException if the ID is null
* @throws EntityNotFoundException if the assistance does not exist
*/
@Override
public void deleteById(Integer id) throws InvalidDataException, EntityNotFoundException {
logger.info("Deleting assistance by ID: {}", id);
@ -75,12 +114,23 @@ public class AssistanceService extends AbstractService<Assistance, Integer> {
super.deleteById(id);
}
/**
* Finds all Assistance records.
*
* @return a list of all assistance records
*/
@Override
public List<Assistance> findAll() {
logger.info("Finding all assistance records");
return super.findAll();
}
/**
* Checks if an Assistance entity exists.
*
* @param entity the assistance entity to check
* @return true if the assistance exists, false otherwise
*/
@Override
protected boolean exists(Assistance entity) {
logger.info("Checking if assistance exists: {}", entity);

95
memberflow-data/src/main/java/com/denniseckerskorn/services/class_managment_services/TrainingGroupService.java
View File

@ -15,17 +15,33 @@ import org.springframework.stereotype.Service;
import java.util.List;
/**
* Service class for managing training groups.
*/
@Service
public class TrainingGroupService extends AbstractService<TrainingGroup, Integer> {
private static final Logger logger = LoggerFactory.getLogger(TrainingGroupService.class);
private final TrainingGroupRepository trainingGroupRepository;
/**
* Constructor for TrainingGroupService.
*
* @param trainingGroupRepository the repository for training groups
*/
public TrainingGroupService(TrainingGroupRepository trainingGroupRepository) {
super(trainingGroupRepository);
this.trainingGroupRepository = trainingGroupRepository;
}
/**
* Saves a new TrainingGroup entity.
*
* @param entity the training group to save
* @return the saved training group
* @throws IllegalArgumentException if the training group is null
* @throws DuplicateEntityException if the training group already exists
*/
@Override
public TrainingGroup save(TrainingGroup entity) throws IllegalArgumentException, DuplicateEntityException {
logger.info("Saving training group: {}", entity);
@ -36,6 +52,15 @@ public class TrainingGroupService extends AbstractService<TrainingGroup, Integer
return super.save(entity);
}
/**
* Updates an existing TrainingGroup entity.
*
* @param entity the training group to update
* @return the updated training group
* @throws IllegalArgumentException if the training group is null
* @throws InvalidDataException if the training group data is invalid
* @throws EntityNotFoundException if the training group does not exist
*/
@Override
public TrainingGroup update(TrainingGroup entity) throws IllegalArgumentException, InvalidDataException, EntityNotFoundException {
logger.info("Updating training group: {}", entity);
@ -43,17 +68,38 @@ public class TrainingGroupService extends AbstractService<TrainingGroup, Integer
return super.update(entity);
}
/**
* Gets the ID of the TrainingGroup entity.
*
* @param entity the training group entity
* @return the ID of the training group
*/
@Override
protected Integer getEntityId(TrainingGroup entity) {
return super.getEntityId(entity);
}
/**
* Finds a TrainingGroup by its ID.
*
* @param id the ID of the training group
* @return the found training group
* @throws InvalidDataException if the ID is invalid
* @throws EntityNotFoundException if the training group does not exist
*/
@Override
public TrainingGroup findById(Integer id) throws InvalidDataException, EntityNotFoundException {
logger.info("Finding training group by ID: {}", id);
return super.findById(id);
}
/**
* Deletes a TrainingGroup by its ID.
*
* @param id the ID of the training group to delete
* @throws InvalidDataException if the ID is invalid
* @throws EntityNotFoundException if the training group does not exist
*/
@Override
public void deleteById(Integer id) throws InvalidDataException, EntityNotFoundException {
logger.info("Deleting training group by ID: {}", id);
@ -65,18 +111,35 @@ public class TrainingGroupService extends AbstractService<TrainingGroup, Integer
super.deleteById(id);
}
/**
* Finds all training groups.
*
* @return a list of all training groups
*/
@Override
public List<TrainingGroup> findAll() {
logger.info("Finding all training groups");
return super.findAll();
}
/**
* Checks if a TrainingGroup exists in the database.
*
* @param entity the training group to check
* @return true if the training group exists, false otherwise
*/
@Override
protected boolean exists(TrainingGroup entity) {
logger.info("Checking if training group exists: {}", entity);
return super.exists(entity);
}
/**
* Validates the TrainingGroup entity.
*
* @param group the training group to validate
* @throws InvalidDataException if the training group data is invalid
*/
private void validateTrainingGroup(TrainingGroup group) throws InvalidDataException {
if (group.getTeacher() == null) {
throw new InvalidDataException("Teacher cannot be null");
@ -89,6 +152,14 @@ public class TrainingGroupService extends AbstractService<TrainingGroup, Integer
}
}
/**
* Adds a student to a training group.
*
* @param group the training group
* @param student the student to add
* @throws InvalidDataException if the group or student is null
* @throws EntityNotFoundException if the group does not exist
*/
@Transactional
public void addStudentToGroup(TrainingGroup group, Student student) throws InvalidDataException, EntityNotFoundException {
if (group == null || student == null) {
@ -104,6 +175,14 @@ public class TrainingGroupService extends AbstractService<TrainingGroup, Integer
}
}
/**
* Removes a student from a training group.
*
* @param group the training group
* @param student the student to remove
* @throws InvalidDataException if the group or student is null
* @throws EntityNotFoundException if the group does not exist
*/
@Transactional
public void removeStudentFromGroup(TrainingGroup group, Student student) throws InvalidDataException, EntityNotFoundException {
if (group == null || student == null) {
@ -119,6 +198,14 @@ public class TrainingGroupService extends AbstractService<TrainingGroup, Integer
}
}
/**
* Adds a training session to a training group.
*
* @param group the training group
* @param session the training session to add
* @throws InvalidDataException if the group or session is null
* @throws EntityNotFoundException if the group does not exist
*/
@Transactional
public void addTrainingSessionToGroup(TrainingGroup group, TrainingSession session) throws InvalidDataException, EntityNotFoundException {
if (group == null || session == null) {
@ -131,6 +218,14 @@ public class TrainingGroupService extends AbstractService<TrainingGroup, Integer
trainingGroupRepository.save(managedGroup);
}
/**
* Removes a training session from a training group.
*
* @param group the training group
* @param session the training session to remove
* @throws InvalidDataException if the group or session is null
* @throws EntityNotFoundException if the group does not exist
*/
@Transactional
public void removeTrainingSessionFromGroup(TrainingGroup group, TrainingSession session) throws InvalidDataException, EntityNotFoundException {
if (group == null || session == null) {

77
memberflow-data/src/main/java/com/denniseckerskorn/services/class_managment_services/TrainingSessionService.java
View File

@ -27,11 +27,24 @@ public class TrainingSessionService extends AbstractService<TrainingSession, Int
private static final Logger logger = LoggerFactory.getLogger(TrainingSessionService.class);
private final TrainingSessionRepository trainingSessionRepository;
/**
* Constructor for TrainingSessionService.
*
* @param trainingSessionRepository the repository for training sessions
*/
public TrainingSessionService(TrainingSessionRepository trainingSessionRepository) {
super(trainingSessionRepository);
this.trainingSessionRepository = trainingSessionRepository;
}
/**
* Saves a new TrainingSession entity.
*
* @param entity the training session to save
* @return the saved training session
* @throws IllegalArgumentException if the training session is null
* @throws DuplicateEntityException if the training session already exists
*/
@Override
public TrainingSession save(TrainingSession entity) throws IllegalArgumentException, DuplicateEntityException {
logger.info("Saving training session: {}", entity);
@ -42,6 +55,15 @@ public class TrainingSessionService extends AbstractService<TrainingSession, Int
return super.save(entity);
}
/**
* Updates an existing TrainingSession entity.
*
* @param entity the training session to update
* @return the updated training session
* @throws IllegalArgumentException if the training session is null
* @throws InvalidDataException if the training session data is invalid
* @throws EntityNotFoundException if the training session does not exist
*/
@Override
public TrainingSession update(TrainingSession entity) throws IllegalArgumentException, InvalidDataException, EntityNotFoundException {
logger.info("Updating training session: {}", entity);
@ -49,17 +71,39 @@ public class TrainingSessionService extends AbstractService<TrainingSession, Int
return super.update(entity);
}
/**
* Gets the ID of the training session entity.
*
* @param entity the training session entity
* @return the ID of the training session
* @throws IllegalStateException if the entity is not managed
*/
@Override
protected Integer getEntityId(TrainingSession entity) throws IllegalStateException {
return super.getEntityId(entity);
}
/**
* Finds a training session by its ID.
*
* @param id the ID of the training session
* @return the found training session
* @throws InvalidDataException if the ID is invalid
* @throws EntityNotFoundException if the training session does not exist
*/
@Override
public TrainingSession findById(Integer id) throws InvalidDataException, EntityNotFoundException {
logger.info("Finding training session by ID: {}", id);
return super.findById(id);
}
/**
* Deletes a training session by its ID.
*
* @param id the ID of the training session to delete
* @throws InvalidDataException if the ID is invalid
* @throws EntityNotFoundException if the training session does not exist
*/
@Override
public void deleteById(Integer id) throws InvalidDataException, EntityNotFoundException {
logger.info("Deleting training session by ID: {}", id);
@ -71,12 +115,23 @@ public class TrainingSessionService extends AbstractService<TrainingSession, Int
super.deleteById(id);
}
/**
* Finds all training sessions.
*
* @return a list of all training sessions
*/
@Override
public List<TrainingSession> findAll() {
logger.info("Finding all training sessions");
return super.findAll();
}
/**
* Checks if a training session exists in the database.
*
* @param entity the training session to check
* @return true if the training session exists, false otherwise
*/
@Override
protected boolean exists(TrainingSession entity) {
logger.info("Checking if training session exists: {}", entity);
@ -98,6 +153,14 @@ public class TrainingSessionService extends AbstractService<TrainingSession, Int
}
}
/**
* Retrieves all students from a specific training session.
*
* @param session the training session
* @return a set of students enrolled in the session
* @throws EntityNotFoundException if the session does not exist
* @throws InvalidDataException if the session is null or has no ID
*/
public Set<Student> getStudentsFromSession(TrainingSession session) throws EntityNotFoundException, InvalidDataException {
if (session == null || session.getId() == null) {
throw new InvalidDataException("Session cannot be null");
@ -107,6 +170,13 @@ public class TrainingSessionService extends AbstractService<TrainingSession, Int
return managedSession.getTrainingGroup().getStudents();
}
/**
* Deletes all assistances for a specific training session.
*
* @param sessionId the ID of the training session
* @throws EntityNotFoundException if the session does not exist
* @throws InvalidDataException if the session ID is null
*/
@Transactional
public void deleteAllAssistancesBySession(Integer sessionId) {
logger.info("Deleting all assistances for session ID: {}", sessionId);
@ -119,6 +189,13 @@ public class TrainingSessionService extends AbstractService<TrainingSession, Int
logger.info("All assistances for session ID: {} have been deleted", sessionId);
}
/**
* Generates recurring training sessions for a given training group.
*
* @param group the training group for which to generate sessions
* @param months the number of months for which to generate sessions
* @throws InvalidDataException if the group is null or has no schedule
*/
@Transactional
public void generateRecurringSession(TrainingGroup group, int months) {
logger.info("Generating recurring sessions for group: {} for {} months", group.getName(), months);

55
memberflow-data/src/main/java/com/denniseckerskorn/services/finance_services/IVATypeService.java
View File

@ -14,6 +14,10 @@ import org.springframework.stereotype.Service;
import java.math.BigDecimal;
import java.util.List;
/**
* Service class for managing IVA types.
* This class provides methods to perform CRUD operations on IVAType entities.
*/
@Service
public class IVATypeService extends AbstractService<IVAType, Integer> {
@ -21,12 +25,25 @@ public class IVATypeService extends AbstractService<IVAType, Integer> {
private final IVATypeRepository ivaTypeRepository;
private final ProductServiceRepository productServiceRepository;
/**
* Constructor for IVATypeService.
*
* @param ivaTypeRepository the repository for IVA types
* @param productServiceRepository the repository for product services
*/
public IVATypeService(IVATypeRepository ivaTypeRepository, ProductServiceRepository productServiceRepository) {
super(ivaTypeRepository);
this.ivaTypeRepository = ivaTypeRepository;
this.productServiceRepository = productServiceRepository;
}
/**
* Saves a new IVAType entity.
*
* @param entity the IVAType to save
* @return the saved IVAType
* @throws DuplicateEntityException if an entity with the same percentage already exists
*/
@Override
public IVAType save(IVAType entity) throws DuplicateEntityException {
logger.info("Saving IVAType: {}", entity);
@ -37,6 +54,14 @@ public class IVATypeService extends AbstractService<IVAType, Integer> {
return super.save(entity);
}
/**
* Updates an existing IVAType entity.
*
* @param entity the IVAType to update
* @return the updated IVAType
* @throws InvalidDataException if the entity data is invalid
* @throws EntityNotFoundException if the entity does not exist
*/
@Override
public IVAType update(IVAType entity) throws InvalidDataException, EntityNotFoundException {
logger.info("Updating IVAType: {}", entity);
@ -44,22 +69,46 @@ public class IVATypeService extends AbstractService<IVAType, Integer> {
return super.update(entity);
}
/**
* Verifies if an IVAType entity exists in the database.
*
* @param entity the entity to check
* @return true if the entity exists, false otherwise
*/
@Override
protected boolean exists(IVAType entity) {
return entity != null && entity.getId() != null && ivaTypeRepository.existsById(entity.getId());
}
/**
* Gets the ID of the IVAType entity.
*
* @param entity the IVAType entity
* @return the ID of the IVAType
*/
@Override
protected Integer getEntityId(IVAType entity) {
return entity.getId();
}
/**
* Finds all IVAType entities.
*
* @return a list of all IVAType entities
*/
@Override
public List<IVAType> findAll() {
logger.info("Retrieving all IVA types");
return super.findAll();
}
/**
* Deletes an IVAType entity by its ID.
*
* @param id the ID of the entity to delete
* @throws InvalidDataException if the ID is null or invalid
* @throws EntityNotFoundException if the entity does not exist
*/
@Override
public void deleteById(Integer id) throws InvalidDataException, EntityNotFoundException {
if (productServiceRepository.existsByIvaTypeId(id)) {
@ -68,6 +117,12 @@ public class IVATypeService extends AbstractService<IVAType, Integer> {
super.deleteById(id);
}
/**
* Validates the IVAType entity before saving or updating.
*
* @param ivaType the IVAType to validate
* @throws InvalidDataException if the IVAType data is invalid
*/
private void validate(IVAType ivaType) {
if (ivaType.getPercentage() == null || ivaType.getPercentage().compareTo(BigDecimal.ZERO) < 0) {
throw new InvalidDataException("IVA percentage must be >= 0");

45
memberflow-data/src/main/java/com/denniseckerskorn/services/finance_services/InvoiceLineService.java
View File

@ -23,11 +23,24 @@ public class InvoiceLineService extends AbstractService<InvoiceLine, Integer> {
private static final Logger logger = LoggerFactory.getLogger(InvoiceLineService.class);
private final InvoiceLineRepository invoiceLineRepository;
/**
* Constructor for InvoiceLineService.
*
* @param invoiceLineRepository the repository for InvoiceLine entities
*/
public InvoiceLineService(InvoiceLineRepository invoiceLineRepository) {
super(invoiceLineRepository);
this.invoiceLineRepository = invoiceLineRepository;
}
/**
* Saves a new InvoiceLine entity.
*
* @param entity the InvoiceLine to save
* @return the saved InvoiceLine
* @throws IllegalArgumentException if the entity is null
* @throws DuplicateEntityException if an entity with the same ID already exists
*/
@Override
public InvoiceLine save(InvoiceLine entity) throws IllegalArgumentException, DuplicateEntityException {
logger.info("Saving invoice line: {}", entity);
@ -35,6 +48,15 @@ public class InvoiceLineService extends AbstractService<InvoiceLine, Integer> {
return super.save(entity);
}
/**
* Updates an existing InvoiceLine entity.
*
* @param entity the InvoiceLine to update
* @return the updated InvoiceLine
* @throws IllegalArgumentException if the entity is null
* @throws InvalidDataException if the entity data is invalid
* @throws EntityNotFoundException if the entity does not exist
*/
@Override
public InvoiceLine update(InvoiceLine entity) throws IllegalArgumentException, InvalidDataException, EntityNotFoundException {
logger.info("Updating invoice line: {}", entity);
@ -42,22 +64,44 @@ public class InvoiceLineService extends AbstractService<InvoiceLine, Integer> {
return super.update(entity);
}
/**
* Finds all InvoiceLine entities.
*
* @return a list of all InvoiceLine entities
*/
@Override
public List<InvoiceLine> findAll() {
logger.info("Retrieving all invoice lines");
return super.findAll();
}
/**
* Verifies if an InvoiceLine entity exists in the repository.
*
* @param entity the entity to check
* @return true if the entity exists, false otherwise
*/
@Override
protected boolean exists(InvoiceLine entity) {
return entity != null && entity.getId() != null && invoiceLineRepository.existsById(entity.getId());
}
/**
* Retrieves the ID of an InvoiceLine entity.
*
* @param entity the entity from which to retrieve the ID
* @return the ID of the InvoiceLine entity
*/
@Override
protected Integer getEntityId(InvoiceLine entity) {
return entity.getId();
}
/**
* Validates the InvoiceLine entity before saving or updating.
*
* @param line the InvoiceLine to validate
*/
private void validateInvoiceLine(InvoiceLine line) {
if (line.getInvoice() == null) {
throw new InvalidDataException("InvoiceLine must be linked to an invoice");
@ -72,7 +116,6 @@ public class InvoiceLineService extends AbstractService<InvoiceLine, Integer> {
throw new InvalidDataException("Unit price must be greater than 0");
}
// Validación automática de subtotal
BigDecimal expected = line.getUnitPrice().multiply(new BigDecimal(line.getQuantity()));
line.setSubtotal(expected);
}

115
memberflow-data/src/main/java/com/denniseckerskorn/services/finance_services/InvoiceService.java
View File

@ -17,17 +17,34 @@ import java.time.LocalDateTime;
import java.util.List;
import java.util.Objects;
/**
* Service class for managing invoices.
* This class provides methods to perform CRUD operations on Invoice entities.
*/
@Service
public class InvoiceService extends AbstractService<Invoice, Integer> {
private static final Logger logger = LoggerFactory.getLogger(InvoiceService.class);
private final InvoiceRepository invoiceRepository;
/**
* Constructor for InvoiceService.
*
* @param invoiceRepository the repository for Invoice entities
*/
public InvoiceService(InvoiceRepository invoiceRepository) {
super(invoiceRepository);
this.invoiceRepository = invoiceRepository;
}
/**
* Saves a new invoice in the database.
*
* @param entity the invoice to save
* @return the saved invoice
* @throws IllegalArgumentException if the invoice is null
* @throws DuplicateEntityException if an invoice with the same ID already exists
*/
@Override
public Invoice save(Invoice entity) throws IllegalArgumentException, DuplicateEntityException {
logger.info("Saving invoice: {}", entity);
@ -38,6 +55,15 @@ public class InvoiceService extends AbstractService<Invoice, Integer> {
return super.save(entity);
}
/**
* Updates an existing invoice in the database.
*
* @param entity the invoice to update
* @return the updated invoice
* @throws IllegalArgumentException if the invoice is null
* @throws InvalidDataException if the invoice data is invalid
* @throws EntityNotFoundException if the invoice does not exist
*/
@Override
public Invoice update(Invoice entity) throws IllegalArgumentException, InvalidDataException, EntityNotFoundException {
logger.info("Updating invoice: {}", entity);
@ -45,12 +71,27 @@ public class InvoiceService extends AbstractService<Invoice, Integer> {
return super.update(entity);
}
/**
* Finds an invoice by its ID.
*
* @param id the ID of the entity to find
* @return the found invoice
* @throws InvalidDataException if the ID is null or invalid
* @throws EntityNotFoundException if the invoice does not exist
*/
@Override
public Invoice findById(Integer id) throws InvalidDataException, EntityNotFoundException {
logger.info("Finding invoice by ID: {}", id);
return super.findById(id);
}
/**
* Deletes an invoice by its ID.
*
* @param id the ID of the invoice to delete
* @throws InvalidDataException if the ID is null or invalid
* @throws EntityNotFoundException if the invoice does not exist
*/
@Override
public void deleteById(Integer id) throws InvalidDataException, EntityNotFoundException {
logger.info("Deleting invoice by ID: {}", id);
@ -61,24 +102,45 @@ public class InvoiceService extends AbstractService<Invoice, Integer> {
super.deleteById(id);
}
/**
* Retrieves all invoices.
*
* @return a list of all invoices
*/
@Override
public List<Invoice> findAll() {
logger.info("Retrieving all invoices");
return super.findAll();
}
/**
* Checks if an invoice exists in the database.
*
* @param entity the invoice to check
* @return true if the invoice exists, false otherwise
*/
@Override
protected boolean exists(Invoice entity) {
return entity != null && entity.getId() != null && invoiceRepository.existsById(entity.getId());
}
/**
* Gets the ID of the invoice entity.
*
* @param entity the invoice entity
* @return the ID of the invoice
*/
@Override
protected Integer getEntityId(Invoice entity) {
return entity.getId();
}
/**
* Obtiene todas las facturas de un usuario específico.
* Finds all invoices associated with a specific user ID.
*
* @param userId the ID of the user
* @return a list of invoices associated with the user
* @throws InvalidDataException if the user ID is null
*/
public List<Invoice> findAllInvoicesByUserId(Integer userId) throws InvalidDataException {
if (userId == null) {
@ -91,7 +153,10 @@ public class InvoiceService extends AbstractService<Invoice, Integer> {
/**
* Validates the invoice before saving/updating.
* Validates the invoice entity.
*
* @param invoice the invoice to validate
* @throws InvalidDataException if the invoice data is invalid
*/
private void validateInvoice(Invoice invoice) throws InvalidDataException {
if (invoice.getUser() == null) {
@ -108,6 +173,13 @@ public class InvoiceService extends AbstractService<Invoice, Integer> {
}
}
/**
* Adds a line to an invoice.
*
* @param invoice the invoice to which the line will be added
* @param line the line to add
* @throws InvalidDataException if the invoice or line is null
*/
@Transactional
public void addLineToInvoice(Invoice invoice, InvoiceLine line) {
if (invoice == null || line == null) {
@ -119,6 +191,13 @@ public class InvoiceService extends AbstractService<Invoice, Integer> {
invoiceRepository.save(invoice);
}
/**
* Removes a line from an invoice.
*
* @param invoice the invoice from which the line will be removed
* @param line the line to remove
* @throws InvalidDataException if the invoice or line is null
*/
@Transactional
public void removeLineFromInvoice(Invoice invoice, InvoiceLine line) {
if (invoice == null || line == null) {
@ -130,6 +209,11 @@ public class InvoiceService extends AbstractService<Invoice, Integer> {
invoiceRepository.save(invoice);
}
/**
* Updates the total amount of an invoice based on its lines.
*
* @param invoice the invoice to update
*/
public void updateInvoiceTotal(Invoice invoice) {
BigDecimal total = BigDecimal.ZERO;
@ -152,13 +236,25 @@ public class InvoiceService extends AbstractService<Invoice, Integer> {
invoice.setTotal(total);
}
/**
* Adds a line to an invoice by its ID.
*
* @param invoiceId the ID of the invoice to which the line will be added
* @param line the line to add
*/
@Transactional
public void addLineToInvoiceById(Integer invoiceId, InvoiceLine line) {
Invoice invoice = findById(invoiceId);
addLineToInvoice(invoice, line);
}
/**
* Removes a line from an invoice by its ID.
*
* @param invoiceId the ID of the invoice from which the line will be removed
* @param lineId the ID of the line to remove
* @throws EntityNotFoundException if the line does not exist in the invoice
*/
@Transactional
public void removeLineFromInvoiceById(Integer invoiceId, Integer lineId) {
Invoice invoice = findById(invoiceId);
@ -169,12 +265,21 @@ public class InvoiceService extends AbstractService<Invoice, Integer> {
removeLineFromInvoice(invoice, line);
}
/**
* Recalculates the total of an invoice and saves it.
*
* @param invoice the invoice to recalculate
*/
public void recalculateTotal(Invoice invoice) {
updateInvoiceTotal(invoice);
invoiceRepository.save(invoice);
}
/**
* Clears all lines from an invoice and updates the total.
*
* @param invoice the invoice to clear lines from
*/
@Transactional
public void clearInvoiceLines(Invoice invoice) {
invoice.getInvoiceLines().clear();

68
memberflow-data/src/main/java/com/denniseckerskorn/services/finance_services/PaymentService.java
View File

@ -17,6 +17,10 @@ import java.math.BigDecimal;
import java.time.LocalDateTime;
import java.util.List;
/**
* Service class for managing Payment entities.
* This class provides methods to perform CRUD operations on Payment entities.
*/
@Service
public class PaymentService extends AbstractService<Payment, Integer> {
@ -24,12 +28,27 @@ public class PaymentService extends AbstractService<Payment, Integer> {
private final PaymentRepository paymentRepository;
private final InvoiceService invoiceService;
/**
* Constructor for PaymentService.
*
* @param paymentRepository the repository for Payment entities
* @param invoiceService the service for Invoice entities
*/
public PaymentService(PaymentRepository paymentRepository, InvoiceService invoiceService) {
super(paymentRepository);
this.paymentRepository = paymentRepository;
this.invoiceService = invoiceService;
}
/**
* Saves a new Payment entity.
*
* @param payment the payment to save
* @return the saved payment
* @throws DuplicateEntityException if a payment already exists for the invoice
* @throws EntityNotFoundException if the associated invoice does not exist
* @throws InvalidDataException if the payment data is invalid
*/
@Override
@Transactional
public Payment save(Payment payment) throws DuplicateEntityException {
@ -50,14 +69,20 @@ public class PaymentService extends AbstractService<Payment, Integer> {
Payment savedPayment = super.save(payment);
//invoice.setPayment(savedPayment);
invoice.setStatus(StatusValues.PAID);
invoiceService.update(invoice);
return savedPayment;
}
/**
* Updates an existing Payment entity.
*
* @param payment the entity to update
* @return the updated payment
* @throws EntityNotFoundException if the payment does not exist
* @throws InvalidDataException if the payment data is invalid
*/
@Override
@Transactional
public Payment update(Payment payment) throws EntityNotFoundException, InvalidDataException {
@ -82,22 +107,44 @@ public class PaymentService extends AbstractService<Payment, Integer> {
return super.update(payment);
}
/**
* Verifies if a Payment entity exists in the database.
*
* @param entity the entity to check
* @return true if the entity exists, false otherwise
*/
@Override
protected boolean exists(Payment entity) {
return entity != null && entity.getId() != null && paymentRepository.existsById(entity.getId());
}
/**
* Obtains the ID of a Payment entity.
*
* @param entity the entity from which to retrieve the ID
* @return the ID of the Payment entity
*/
@Override
protected Integer getEntityId(Payment entity) {
return entity.getId();
}
/**
* Obtains all Payment entities.
*
* @return a list of all Payment entities
*/
@Override
public List<Payment> findAll() {
logger.info("Retrieving all payments");
return super.findAll();
}
/**
* Validates the Payment entity before saving or updating.
*
* @param payment the Payment to validate
*/
private void validate(Payment payment) {
if (payment.getInvoice() == null) {
throw new InvalidDataException("Payment must be linked to an invoice");
@ -116,6 +163,11 @@ public class PaymentService extends AbstractService<Payment, Integer> {
}
}
/**
* Removes a Payment entity by its ID.
*
* @param paymentId the ID of the payment to remove
*/
@Transactional
public void removePayment(Integer paymentId) {
Payment payment = findById(paymentId);
@ -131,10 +183,22 @@ public class PaymentService extends AbstractService<Payment, Integer> {
invoiceService.update(invoice);
}
/**
* Finds all Payment entities associated with a specific user ID.
*
* @param userId the ID of the user
* @return a list of payments associated with the user
*/
public List<Payment> findAllByUserId(Integer userId) {
return paymentRepository.findByInvoice_User_Id(userId);
}
/**
* Retrieves an Invoice by its ID.
*
* @param id the ID of the invoice
* @return the Invoice entity
*/
public Invoice getInvoiceById(Integer id) {
return invoiceService.findById(id);
}

50
memberflow-data/src/main/java/com/denniseckerskorn/services/finance_services/ProductServiceService.java
View File

@ -15,6 +15,10 @@ import org.springframework.stereotype.Service;
import java.math.BigDecimal;
import java.util.List;
/**
* Service class for managing ProductService entities.
* This class provides methods to perform CRUD operations on ProductService entities.
*/
@Service
public class ProductServiceService extends AbstractService<ProductService, Integer> {
@ -22,12 +26,26 @@ public class ProductServiceService extends AbstractService<ProductService, Integ
private final ProductServiceRepository productServiceRepository;
private final IVATypeService ivaTypeService;
/**
* Constructor for ProductServiceService.
*
* @param productServiceRepository the repository for ProductService entities
* @param ivaTypeService the service for IVAType entities
*/
public ProductServiceService(ProductServiceRepository productServiceRepository, IVATypeService ivaTypeService) {
super(productServiceRepository);
this.productServiceRepository = productServiceRepository;
this.ivaTypeService = ivaTypeService;
}
/**
* Saves a new ProductService entity.
*
* @param entity the product/service to save
* @return the saved product/service
* @throws IllegalArgumentException if the product/service is invalid
* @throws DuplicateEntityException if a product/service with the same name already exists
*/
@Override
@Transactional
public ProductService save(ProductService entity) throws IllegalArgumentException, DuplicateEntityException {
@ -51,6 +69,15 @@ public class ProductServiceService extends AbstractService<ProductService, Integ
}
/**
* Updates an existing ProductService entity.
*
* @param entity the product/service to update
* @return the updated product/service
* @throws IllegalArgumentException if the product/service is invalid
* @throws InvalidDataException if the product/service data is invalid
* @throws EntityNotFoundException if the product/service does not exist
*/
@Override
@Transactional
public ProductService update(ProductService entity) throws IllegalArgumentException, InvalidDataException, EntityNotFoundException {
@ -68,23 +95,44 @@ public class ProductServiceService extends AbstractService<ProductService, Integ
return super.update(entity);
}
/**
* Finds all ProductService entities.
*
* @return a list of all products/services
*/
@Override
public List<ProductService> findAll() {
logger.info("Retrieving all products/services");
return super.findAll();
}
/**
* Exists method to check if a ProductService entity exists in the repository.
*
* @param entity the entity to check
* @return true if the entity exists, false otherwise
*/
@Override
protected boolean exists(ProductService entity) {
return entity != null && entity.getId() != null && productServiceRepository.existsById(entity.getId());
}
/**
* Gets the ID of a ProductService entity.
*
* @param entity the entity from which to retrieve the ID
* @return the ID of the ProductService entity
*/
@Override
protected Integer getEntityId(ProductService entity) {
return entity.getId();
}
/**
* Validates the ProductService entity before saving or updating.
*
* @param product the ProductService to validate
*/
private void validateProduct(ProductService product) {
if (product.getName() == null || product.getName().isBlank()) {
throw new InvalidDataException("Product name cannot be null or blank");

8
memberflow-data/src/main/java/com/denniseckerskorn/services/user_managment_services/NotificationService.java
View File

@ -67,6 +67,14 @@ public class NotificationService extends AbstractService<Notification, Integer>
return super.findById(id);
}
/**
* Updates an existing notification.
*
* @param entity the notification to update
* @return the updated notification
* @throws EntityNotFoundException if the notification is not found
* @throws InvalidDataException if the entity data is invalid
*/
@Transactional
@Override
public Notification update(Notification entity) throws EntityNotFoundException {

4
memberflow-data/src/main/java/com/denniseckerskorn/services/user_managment_services/StudentService.java
View File

@ -34,7 +34,9 @@ public class StudentService extends AbstractService<Student, Integer> {
/**
* Constructor for StudentService.
*
* @param studentRepository the student repository
* @param studentRepository the student repository
* @param userRepository the user repository
* @param assistanceRepository the assistance repository
*/
public StudentService(StudentRepository studentRepository, UserRepository userRepository, AssistanceRepository assistanceRepository) {
super(studentRepository);

1
memberflow-data/src/main/java/com/denniseckerskorn/services/user_managment_services/TeacherService.java
View File

@ -33,6 +33,7 @@ public class TeacherService extends AbstractService<Teacher, Integer> {
* Constructor for TeacherService.
*
* @param teacherRepository the teacher repository
* @param userRepository the user repository
*/
public TeacherService(TeacherRepository teacherRepository, UserRepository userRepository) {
super(teacherRepository);

14
memberflow-data/src/main/java/com/denniseckerskorn/services/user_managment_services/UserService.java
View File

@ -156,6 +156,13 @@ public class UserService extends AbstractService<User, Integer> {
return userRepository.existsByEmail(email);
}
/**
* Adds an invoice to a user.
*
* @param user the user to whom the invoice will be added
* @param invoice the invoice to add
* @throws InvalidDataException if the user or invoice is null
*/
@Transactional
public void addInvoiceToUser(User user, Invoice invoice) throws InvalidDataException {
if (user == null || invoice == null) {
@ -167,6 +174,13 @@ public class UserService extends AbstractService<User, Integer> {
userRepository.save(user);
}
/**
* Removes an invoice from a user.
*
* @param user the user from whom the invoice will be removed
* @param invoice the invoice to remove
* @throws InvalidDataException if the user or invoice is null
*/
@Transactional
public void removeInvoiceFromUser(User user, Invoice invoice) throws InvalidDataException {
if (user == null || invoice == null) {