docs: add missing javadocs

Author: mlopezFC

backend-core-business-impl/src/main/java/com/flowingcode/backendcore/service/validation/CreationValidator.java

@@ -28,6 +28,12 @@
 import com.flowingcode.backendcore.model.ErrorDescription;
 import com.flowingcode.backendcore.validation.Validator;
 
+/**
+ * Validator for creation operations on entities.
+ *
+ * @param <T> the type being validated
+ * @author mlopez
+ */
 public interface CreationValidator<T> extends Validator<T> {
 
   default CreationValidator<T> and(CreationValidator<T> then) {

backend-core-business-impl/src/main/java/com/flowingcode/backendcore/service/validation/DeletionValidator.java

@@ -28,6 +28,12 @@
 import com.flowingcode.backendcore.model.ErrorDescription;
 import com.flowingcode.backendcore.validation.Validator;
 
+/**
+ * Validator for deletion operations on entities.
+ *
+ * @param <T> the type being validated
+ * @author mlopez
+ */
 public interface DeletionValidator<T> extends Validator<T> {
 
   default DeletionValidator<T> and(DeletionValidator<T> then) {

backend-core-business-impl/src/main/java/com/flowingcode/backendcore/service/validation/InvariantValidator.java

@@ -10,6 +10,12 @@
 import com.flowingcode.backendcore.service.validation.UpdateValidator;
 import com.flowingcode.backendcore.validation.Validator;
 
+/**
+ * Validator that enforces invariants during both creation and update operations.
+ *
+ * @param <T> the type being validated
+ * @author jgodoy
+ */
 public interface InvariantValidator<T> extends CreationValidator<T>, UpdateValidator<T> {
 
   default InvariantValidator<T> and(InvariantValidator<T> then) {

backend-core-business-impl/src/main/java/com/flowingcode/backendcore/service/validation/ServiceValidationKind.java

@@ -6,6 +6,11 @@
 import lombok.Getter;
 import lombok.RequiredArgsConstructor;
 
+/**
+ * Enumeration of service validation kinds corresponding to different operation types.
+ *
+ * @author mlopez
+ */
 @RequiredArgsConstructor
 public enum ServiceValidationKind implements ValidationKind {
 

backend-core-business-impl/src/main/java/com/flowingcode/backendcore/service/validation/UpdateValidator.java

@@ -28,6 +28,12 @@
 import com.flowingcode.backendcore.model.ErrorDescription;
 import com.flowingcode.backendcore.validation.Validator;
 
+/**
+ * Validator for update operations on entities.
+ *
+ * @param <T> the type being validated
+ * @author mlopez
+ */
 public interface UpdateValidator<T> extends Validator<T> {
 
   default UpdateValidator<T> and(UpdateValidator<T> then) {

backend-core-business-spring-impl/src/main/java/com/flowingcode/backendcore/service/ConstraintSpecification.java

@@ -13,6 +13,12 @@
 import lombok.AccessLevel;
 import lombok.RequiredArgsConstructor;
 
+/**
+ * Spring Data JPA {@link org.springframework.data.jpa.domain.Specification} that applies a model {@link com.flowingcode.backendcore.model.Constraint}.
+ *
+ * @param <T> the entity type
+ * @author jgodoy
+ */
 @SuppressWarnings("serial")
 @RequiredArgsConstructor(access = AccessLevel.PRIVATE)
 final class ConstraintSpecification<T> implements Specification<T> {

backend-core-data-impl/src/main/java/com/flowingcode/backendcore/dao/jpa/ConstraintTransformerJpaImpl.java

@@ -44,6 +44,11 @@
 import lombok.NonNull;
 import lombok.RequiredArgsConstructor;
 
+/**
+ * JPA implementation of {@link com.flowingcode.backendcore.model.ConstraintTransformer} for converting model constraints into JPA {@link jakarta.persistence.criteria.Predicate} instances.
+ *
+ * @author jgodoy
+ */
 @RequiredArgsConstructor
 public class ConstraintTransformerJpaImpl extends ConstraintTransformer<Predicate> {
 

backend-core-data-impl/src/main/java/com/flowingcode/backendcore/dao/jpa/ConversionJpaDaoSupport.java

@@ -39,6 +39,14 @@
 import com.flowingcode.backendcore.model.Identifiable;
 import com.flowingcode.backendcore.model.QuerySpec;
 
+/**
+ * DAO support interface that converts between source domain type S and persistent entity type T and provides generic CRUD operations.
+ *
+ * @param <S> the source domain type
+ * @param <T> the persistent entity type
+ * @param <K> the identifier type
+ * @author mlopez
+ */
 public interface ConversionJpaDaoSupport<S, T extends Identifiable<K>, K extends Serializable>
 		extends CrudDao<S, K> {
 

backend-core-data-impl/src/main/java/com/flowingcode/backendcore/dao/jpa/JpaDaoSupport.java

@@ -23,6 +23,13 @@
 
 import com.flowingcode.backendcore.model.Identifiable;
 
+/**
+ * DAO support interface for JPA entities, providing default identity conversions.
+ *
+ * @param <T> the persistent entity type
+ * @param <K> the identifier type
+ * @author mlopez
+ */
 public interface JpaDaoSupport<T extends Identifiable<K>, K extends Serializable>
 		extends ConversionJpaDaoSupport<T, T, K> {
 

backend-core-data/src/main/java/com/flowingcode/backendcore/dao/CreationDao.java

@@ -19,6 +19,13 @@
  */
 package com.flowingcode.backendcore.dao;
 
+/**
+ * Data access interface for creating entities of type T.
+ *
+ * @param <T> the entity type
+ * @param <K> the identifier type returned upon creation
+ * @author mlopez
+ */
 public interface CreationDao<T, K> {
 
 	K save(T entity);