1. Fundamentos

Principios fundamentales de código limpio, mantenible y escalable que aplican a cualquier lenguaje o framework.

1.1 📊 Niveles de Criticidad

Ver Tabla de Niveles de Criticidad en el Índice General.

1.2 🌐 Fundamentos de Red

¿Por qué? Comprender cómo se comunican los sistemas es fundamental para desarrollar aplicaciones distribuidas, APIs y servicios en la nube.

¿Quién? Todo desarrollador, especialmente aquellos trabajando con aplicaciones web, APIs y microservicios.

¿Cuánto cuesta? Conocimiento base esencial, inversión de 1-2 días para conceptos fundamentales.

1.2.1 Ejemplo: Flujo Cliente-Servidor con DNS

sequenceDiagram
    participant Cliente
    participant DNS
    participant LoadBalancer
    participant Servidor1
    participant Servidor2

    Cliente->>DNS: ¿Cuál es la IP de api.example.com?
    DNS-->>Cliente: 203.0.113.10
    Cliente->>LoadBalancer: GET /users (203.0.113.10:443)
    LoadBalancer->>Servidor1: Forward request
    Servidor1-->>LoadBalancer: Response {users: [...]}
    LoadBalancer-->>Cliente: Response {users: [...]}

    Note over Cliente,Servidor2: Siguiente request puede ir a Servidor2

1.3 🧠 Reglas Generales de Código

¿Por qué? Estos principios son la base de código profesional que resiste el paso del tiempo y facilita el trabajo en equipo.

¿Quién? Todo desarrollador del equipo, sin importar su rol o nivel de experiencia.

¿Cuánto cuesta? Inversión inicial en aprendizaje (1-2 semanas), ahorro exponencial en mantenimiento.

1.4 🧱 Reglas por Lenguaje

¿Por qué? Cada lenguaje tiene idioms y herramientas específicas que mejoran calidad y productividad.

1.5 🧩 Reglas por Framework

¿Por qué? Los frameworks establecen patrones que, si se siguen, maximizan productividad y maintainability.

1.5.1 Spring Boot - Features Avanzados

Qué es: Funcionalidades avanzadas de Spring Boot para acelerar desarrollo y mejorar mantenibilidad.

Cuándo: Proyectos empresariales que necesitan auditoría, REST rápido, y tareas batch.

Ejemplo @EntityListeners:

@Entity
@EntityListeners(AuditingEntityListener.class)
public class User {
    @CreatedDate
    private LocalDateTime createdAt;

    @LastModifiedDate
    private LocalDateTime updatedAt;

    @CreatedBy
    private String createdBy;

    @LastModifiedBy
    private String lastModifiedBy;
}

@Configuration
@EnableJpaAuditing
public class JpaConfig {
    @Bean
    public AuditorAware<String> auditorProvider() {
        return () -> Optional.of(SecurityContextHolder
            .getContext()
            .getAuthentication()
            .getName());
    }
}

Ejemplo Specifications:

// Repository
public interface UserRepository extends JpaRepository<User, Long>, 
                                         JpaSpecificationExecutor<User> {}

// Specification
public class UserSpecifications {
    public static Specification<User> hasEmail(String email) {
        return (root, query, cb) -> 
            cb.equal(root.get("email"), email);
    }

    public static Specification<User> isActive() {
        return (root, query, cb) -> 
            cb.isTrue(root.get("active"));
    }
}

// Uso: búsqueda dinámica
Specification<User> spec = Specification
    .where(hasEmail("user@example.com"))
    .and(isActive());
List<User> users = userRepository.findAll(spec);

Ejemplo Spring Data REST:

@RepositoryRestResource(path = "users", excerptProjection = UserSummary.class)
public interface UserRepository extends JpaRepository<User, Long> {

    @RestResource(path = "by-email", rel = "by-email")
    User findByEmail(@Param("email") String email);
}

// GET /users → lista todos
// GET /users/1 → usuario específico
// POST /users → crear
// GET /users/search/by-email?email=x → custom query

1.6 🎯 Checklist de Código Limpio

Antes de cada commit, verificar:

• [ ] Nombres de variables/funciones son claros y descriptivos
• [ ] No hay código comentado (usar control de versiones)
• [ ] No hay console.log(), print() de debugging
• [ ] Funciones tienen máximo 30 líneas
• [ ] Sin magic numbers (usar constantes con nombres)
• [ ] Tests unitarios para lógica no trivial
• [ ] Documentación para funciones públicas
• [ ] Principio de Bajo Acoplamiento y Alta Cohesión respetado
• [ ] Sin warnings del linter/compiler
• [ ] Código formateado con herramienta del equipo