Knowledge, Innovation & Navigation
Una plataforma tecnológica creada para transformar ideas e información dispersa en proyectos más estructurados, analizables y accionables.
La plataforma
KIN es una plataforma de inteligencia y estructuración estratégica orientada a emprendedores, empresarios, organizaciones y personas que necesitan estructurar una idea o un proyecto, o analizar y evolucionar uno existente.
Su propósito es ayudar a transformar información dispersa en contexto estructurado, evaluación, conocimiento, riesgos, oportunidades, recomendaciones y documentación profesional reproducible.
KIN no es un chatbot con una interfaz atractiva: es una plataforma tecnológica en la que la inteligencia artificial es un componente dentro de una arquitectura mayor, con un motor determinista que decide y una capa de IA que comunica.
KIN es una herramienta de apoyo al análisis y a la toma de decisiones: no garantiza éxito empresarial ni reemplaza consultores, abogados u otros profesionales.
El origen
KIN nació como una iniciativa de aprendizaje práctico: aprender construyendo. Fue la forma de aplicar conocimientos reales de análisis de software, arquitectura, backend, frontend, bases de datos, inteligencia artificial, seguridad, testing, DevOps y cloud sobre un problema concreto.
Con el tiempo el proyecto fue más allá de un ejercicio académico: se convirtió en una plataforma tecnológica real, desplegada y en evolución, sobre la cual su creador continúa aprendiendo.
KIN comenzó como una forma de aprender y evolucionó hacia una plataforma real desde la que seguir aprendiendo.
Trayectoria conceptual
Una representación conceptual de cómo KIN pasó de ser una idea a una plataforma completa. No es un historial cronológico exacto: describe las etapas de maduración del proyecto.
Identificación de un problema real: estructurar información dispersa de proyectos.
Construcción inicial para aplicar conocimientos de desarrollo de software.
Separación de responsabilidades y evolución hacia una arquitectura mantenible.
Integración de IA dentro de una arquitectura controlada y determinista.
Incorporación de conocimiento externo mediante selección determinista y fuentes controladas.
Evolución de controles de autenticación, autorización, protección de red y SSRF.
Automatización progresiva de pruebas unitarias, de integración y E2E.
Despliegue de la plataforma en infraestructura cloud.
KIN continúa siendo un proyecto vivo, construido para incorporar nuevas capacidades.
KIN y la inteligencia artificial
KIN no fue concebida como un chatbot con una interfaz bonita. La inteligencia artificial es un componente dentro de una arquitectura mayor.
Las decisiones críticas del sistema se toman en el motor determinista: el contexto, las reglas, la adquisición de conocimiento y las fuentes están gobernados por políticas, no por el modelo.
El modelo de lenguaje se usa para comunicar y explicar los resultados. De ahí el principio que guía el proyecto: «Java decide. El LLM únicamente comunica».
Java decide. El LLM únicamente comunica.
Conocimiento
Uno de los retos de una plataforma inteligente es distinguir entre conocimiento generado por un modelo e información externa que puede obtenerse, validarse y trazarse.
KIN aborda este reto con un Knowledge Engine: puede trabajar con conocimiento externo bajo reglas controladas, con selección determinista, fuentes autorizadas, validación, evidencia, trazabilidad y seguridad.
Los detalles técnicos de cómo funciona se explican en la página de arquitectura técnica.
Una plataforma adaptable
KIN fue diseñada para trabajar con diferentes categorías o verticales de proyecto. Cada proyecto se clasifica en una de 19 categorías y el análisis se adapta a ese contexto.
Esta flexibilidad permite que KIN se adapte a distintos sectores y tipos de proyecto, siempre con el mismo motor determinista y la misma arquitectura.
Usuarios
Personas que están estructurando una idea y necesitan convertir información dispersa en un proyecto más claro.
Personas que necesitan analizar proyectos existentes y organizar información para apoyar la toma de decisiones.
Equipos que pueden utilizar herramientas tecnológicas para estructurar información y apoyar procesos internos de análisis.
KIN también representa un entorno real para comprender cómo se construye, prueba, protege y despliega software.
El proyecto
Luis Orlando Guerra González
KIN fue concebida y desarrollada por Luis Orlando Guerra González, desarrollador de software y Tecnólogo de Análisis y Desarrollo de Software, con interés en el desarrollo full-stack, la calidad del software, la arquitectura y la inteligencia artificial.
Es un proyecto construido de forma autodidacta y disciplinada: cada módulo, integración y prueba representa práctica real sobre problemas concretos, no solo teoría.
KIN no demuestra que su creador ya lo sabe todo. Demuestra que puede aprender, construir, validar y evolucionar un sistema real: desde el análisis y el diseño hasta la implementación, las pruebas, la seguridad y el despliegue.
Su objetivo es continuar creciendo dentro de la ingeniería de software, trabajar junto a equipos de desarrollo, recibir code reviews y críticas constructivas, aprender de profesionales con más experiencia y aportar lo aprendido durante la construcción de KIN.
Mi motivación no se limita a construir software por construirlo. La idea es utilizar tecnología para resolver problemas, facilitar procesos, ayudar a estructurar ideas, acercar herramientas tecnológicas y aportar soluciones útiles.
KIN es una muestra de ese propósito: el aprendizaje constante puede convertirse en soluciones tecnológicas capaces de aportar valor a personas y organizaciones.
Quiero continuar creciendo como desarrollador, aprender de otros profesionales y formar parte de equipos de ingeniería donde pueda aportar lo que he aprendido y, al mismo tiempo, seguir aprendiendo de personas con mayor experiencia.
La tecnología cambia constantemente. Por eso considero que un buen desarrollador nunca termina de aprender.
Aprendizaje en práctica
KIN representa un proceso de aprendizaje llevado a la práctica.
Cada módulo, cada integración, cada prueba y cada problema resuelto forma parte de una búsqueda continua por comprender cómo se construyen sistemas de software cada vez más sólidos, seguros, mantenibles y útiles.
El proyecto seguirá evolucionando junto con las necesidades de sus usuarios y con la evolución de la tecnología.
Engineering Showcase
Las áreas de ingeniería que KIN implementa hoy, verificadas en el código del proyecto.
La interfaz de usuario de KIN.
Next.js
App Router, rutas estáticas y renderizado del lado del servidor.
React
Interfaces de usuario por componentes.
TypeScript
Tipado estático estricto en todo el frontend.
Tailwind CSS
Sistema de estilos del frontend.
Playwright
Pruebas E2E del flujo completo.
Vitest
Pruebas unitarias con Testing Library.
Node.js
Runtime del tooling y del build.
Servicios y API REST de la plataforma.
Java
Lenguaje principal del backend (Java 17).
Spring Boot
Framework REST, seguridad y persistencia.
Spring Security
Autenticación y autorización de la API.
JPA / Hibernate
Persistencia orientada a objetos.
PostgreSQL
Base de datos relacional.
Flyway
Migraciones versionadas del esquema (V1…V29).
JWT
Sesiones stateless firmadas (jjwt).
La integración de IA real de KIN.
DeepSeek
Proveedor de IA actual (vía API compatible con OpenAI).
Spring AI
Integración del modelo con el backend.
Orquestación por etapas
Pipeline de 16 etapas que analiza, evalúa y genera el reporte.
Procesamiento de contexto
Contexto durable del proyecto entre turnos de conversación.
Validación automatizada y prevención de regresiones.
Tests unitarios
JUnit 5 + Mockito (backend) y Vitest (frontend).
Tests de integración
Testcontainers sobre PostgreSQL real.
Pruebas E2E
Playwright sobre login, dashboard y proyectos.
Validación de builds
next build y mvn verify en CI.
Lint
ESLint (frontend) y Checkstyle/SpotBugs/PMD (backend).
Pruebas de regresión
Suite completa ejecutada en cada iteración.
436
tests frontend
75
archivos de test
4/4
E2E Sobre KIN
Métricas verificadas en la última ejecución local de la suite de pruebas. Se actualizan con cada nueva ejecución.
Protección de recursos y manejo de errores.
JWT
Tokens firmados para sesiones stateless.
Spring Security
Cadena de filtros y protección de endpoints.
Ownership de proyectos
Acceso controlado por propietario del proyecto.
Autorización
Roles de usuario (FREE, PREMIUM, FACILITADOR, ADMIN).
Validación de acceso
Verificación de sesión en rutas protegidas.
Manejo de errores
GlobalExceptionHandler con respuestas consistentes.
Despliegue y operación de la aplicación.
Docker
PostgreSQL, backend y frontend en contenedores (docker-compose).
GitHub Actions
CI/CD: lint, tests, build y E2E en cada push y PR.
Render
Despliegue en la nube del backend y del frontend.
PostgreSQL
Base de datos gestionada en el despliegue.
Stack real
Cada tecnología de esta lista está presente en el código actual de KIN. No se muestran herramientas que solo aparezcan en documentación.
Lenguajes y frameworks con los que se construye KIN.
React
Interfaces de usuario componentizadas.
Next.js
Framework full-stack del frontend (App Router).
TypeScript
Tipado estático estricto en todo el frontend.
Java
Lenguaje principal del backend (Java 17).
Spring Boot
Framework del backend: REST, seguridad y persistencia.
Node.js
Runtime del tooling y del build del frontend.
Servicios y API REST que soportan la plataforma.
APIs REST
Endpoints bajo /api/v1 consumidos por el frontend.
Spring Security
Autenticación y autorización de la API.
JWT
Sesiones stateless firmadas (jjwt).
JPA / Hibernate
Persistencia orientada a objetos sobre PostgreSQL.
Arquitectura por capas
Controller → Service → Port/Adapter + dominio puro.
Manejo global de excepciones
GlobalExceptionHandler (@RestControllerAdvice).
Persistencia y gestión de la información de los proyectos.
PostgreSQL
Base de datos relacional en dev, test y producción.
Migraciones de base de datos
Flyway versiona el esquema (V1…V29).
Persistencia
Entidades JPA: usuarios, proyectos, reportes, suscripciones.
Datos estructurados del proyecto
Información del proyecto por secciones (project_info).
Integración real de IA que usa KIN hoy.
DeepSeek
Proveedor de IA actual (vía API compatible con OpenAI).
Spring AI
Integración del modelo con el backend.
Orquestación por etapas
Pipeline de 16 etapas: análisis, conocimiento, scoring, reporte y conversación.
Contexto durable
El contexto del proyecto persiste entre turnos.
Pruebas automatizadas y verificación del software.
Testing automatizado
JUnit 5 + Mockito (backend) y Vitest (frontend).
Vitest
Tests unitarios del frontend con Testing Library.
Playwright
Tests E2E del flujo completo (login, dashboard, proyectos).
Pruebas de integración de API
Testcontainers sobre PostgreSQL real.
Cobertura de código
JaCoCo con mínimo 90 % en los módulos de dominio.
Construcción, versionado y despliegue de KIN.
Docker
Contenedores para PostgreSQL, backend y frontend.
Git
Control de versiones del proyecto.
GitHub
Control de versiones, integración continua y despliegue (LuisAIDev).
Render
Despliegue en la nube del backend y del frontend.
Procesamiento de documentos y exportación de reportes.
Procesamiento de documentos
Carga y análisis de PDF, DOCX y XLSX.
Extracción de texto
Texto extraído de documentos para el proyecto.
Generación de PDF
Reportes exportables a PDF (OpenPDF y jsPDF).
Generación de DOCX
Exportación del proyecto a Word.
Exportación Markdown
Exportación del proyecto a Markdown.
Sistema real
Representación de las capas que existen hoy en el código, sin componentes inventados.
KIN
Plataforma full-stack
Frontend
Next.js · React · TypeScript
Backend
Spring Boot · Java 17
IA
Orquestador de 16 etapas
PostgreSQL
Persistencia · contexto · reportes
Cloud / Docker
Render · GitHub Actions · docker-compose
Entrada del usuario
Formularios y chat del frontend
Frontend
Next.js 16 · React 19 · TypeScript
API REST
Endpoints /api/v1 protegidos con JWT
Backend
Spring Boot: controladores, servicios, puertos y adaptadores
Seguridad
Spring Security + JWT + ownership de proyectos
Persistencia
JPA / Hibernate sobre PostgreSQL (Flyway V1…V29)
IA
DeepSeek vía Spring AI + pipeline de 16 etapas
Documentos
Carga y extracción de texto (PDF, DOCX, XLSX)
Reportes y exportación
PDF, DOCX y Markdown desde el reporte del proyecto
Testing
JUnit, Vitest, Playwright y Testcontainers
Despliegue
Docker, GitHub Actions y Render
Usuario
Navegador web
Frontend KIN
Next.js 16 · React 19 · TypeScript
API REST
/api/v1 · JWT (Spring Security)
Spring Boot
Controladores y servicios · Java 17
Servicios · Seguridad · Persistencia
Puertos, adaptadores y entidades JPA
PostgreSQL
Base de datos relacional
KIN
Frontend + backend
Backend
Orquestador de conversación y pipeline
Orquestación IA
16 etapas del pipeline inteligente
Modelo / proveedor
DeepSeek vía Spring AI
Contexto durable
Persistencia del contexto en PostgreSQL
Una visión de ingeniería sobre cómo KIN combina arquitectura de software, inteligencia artificial determinista, seguridad, testing y cloud.
Explorar arquitectura técnicaCapacidades
Cada tarjeta corresponde a una capacidad respaldada por el código y el flujo real del proyecto.
Convertir una necesidad real en componentes y funcionalidades.
Separar responsabilidades y construir módulos mantenibles.
Construcción full-stack de funcionalidades reales.
Integración de modelos y servicios de IA dentro de una arquitectura de software.
Validación automatizada y pruebas de regresión.
Autenticación, autorización y protección de recursos.
Despliegue y operación de una aplicación real.
Analizar problemas existentes, proponer mejoras y evolucionar el sistema sin romper funcionalidades.
Futuro
KIN ha sido concebida con una visión de evolución a largo plazo.
La intención no es predecir cómo será la tecnología dentro de 15 o 20 años, sino construir una base suficientemente sólida para que nuevas capacidades puedan incorporarse a medida que evolucionen las necesidades de los usuarios y el ecosistema tecnológico.
El software cambia constantemente. Por eso la arquitectura debe permitir aprender, adaptarse y evolucionar.
Crecimiento profesional
Mi objetivo profesional es trabajar con equipos de ingeniería, aprender buenas prácticas de equipos con experiencia y participar en proyectos reales donde las decisiones de arquitectura, testing, seguridad y calidad importan.
Quiero recibir code reviews, aprender arquitectura de software, fortalecer mis habilidades de testing, seguridad, DevOps y cloud, y continuar evolucionando en inteligencia artificial.
En tecnología nunca se termina de aprender: cada sistema real enseña algo nuevo, y eso es lo que busco en un equipo profesional.
Origen
KIN nació del interés por aprender haciendo: construir una solución real que apoye a emprendedores, empresarios y organizaciones, y que a la vez demuestre mediante hechos lo que puedo construir.
No fue creada con un objetivo comercial. Fue creada para practicar análisis, arquitectura, desarrollo full-stack, integración con IA, seguridad, testing y evolución constante sobre un problema real.
KIN no representa el final de mi aprendizaje. Representa una evidencia de lo que he aprendido hasta ahora y una plataforma desde la cual quiero seguir aprendiendo.
No lo sé todo: construí KIN, la probé, la corregí y la desplegué. Eso es lo que el proyecto demuestra: capacidad de aprender y de llevar un sistema real hasta producción.
Futuro
Mi siguiente paso no es dejar de aprender porque construí KIN. Es precisamente lo contrario. Estas son áreas de crecimiento profesional, no funcionalidades que KIN ya implementa.
Son áreas que quiero profundizar con práctica real y con equipos que me permitan crecer, no áreas que afirmo dominar.
KIN no representa el final de mi aprendizaje.
Representa una evidencia de hasta dónde puedo llegar cuando decido aprender, construir y perseverar.
Y todavía queda mucho por aprender.