🌄 Parina Framework (Java 21)

Este repositorio contiene la implementación de Parina Framework utilizando Java 21 y Maven. El framework implementa una arquitectura limpia, orientada a características (Feature-Driven Architecture - FDA), el patrón Command Query Responsibility Segregation (CQS), un servidor HTTP nativo sin dependencias pesadas utilizando Virtual Threads de Java 21, y el auditor de cumplimiento de reglas de arquitectura Parina Guardian con análisis estático de AST vía JavaParser.

---

🚀 Requisitos Previos

• Java 21+ (openjdk 21 o compatible).
• Maven 3.9+ instalado.

---

🛠️ Instalación y Configuración

Para descargar dependencias y compilar el proyecto:

mvn clean compile

---

💻 Comandos Disponibles

1. Iniciar el Servidor Web

Arranca la aplicación web nativa sobre com.sun.net.httpserver.HttpServer con soporte nativo de Virtual Threads en el puerto 8080:

mvn exec:java -Dexec.mainClass="app.Main"

Endpoints disponibles una vez iniciado:

• http://localhost:8080/ -> Renderiza una página HTML nativa de inicio.
• http://localhost:8080/about -> Información del framework.
• http://localhost:8080/users -> Retorna un JSON con el listado de usuarios desde la base de datos SQLite en memoria.
• http://localhost:8080/login -> Interfaz HTML y endpoint de inicio de sesión.

2. Ejecutar la Suite de Pruebas

Ejecuta la suite de pruebas unitarias integradas utilizando JUnit 5:

mvn test

3. Ejecutar la Auditoría con Parina Guardian

Ejecuta el analizador estático de AST (Abstract Syntax Tree) usando JavaParser para validar las reglas arquitectónicas del proyecto y exportar un reporte en formato estándar SARIF v2.1.0:

mvn exec:java -Dexec.mainClass="com.parina.guardian.GuardianCli" -Dexec.args="--format sarif --output guardian-results.sarif"

---

📂 Estructura del Framework

• src/main/java/com/parina/core/: Abstracciones de enrutamiento, pipeline de middlewares, respuestas y kernel HTTP basado en com.sun.net.httpserver potenciado con hilos virtuales.
• src/main/java/com/parina/shared/: Infraestructura común, adaptador de base de datos SQLite (sqlite-jdbc), generador SQL y middlewares compartidos.
• src/main/java/app/: Implementación FDA (Feature-Driven Architecture) con las características home, authentication y user_management.
• src/main/java/com/parina/guardian/: Herramienta de auditoría estática basada en JavaParser estructurada en 5 fases para validar el acoplamiento y límites arquitectónicos.