Sobre el Catálogo
El Catálogo de Componentes es una colección navegable de diecisiete componentes de software recurrentes que aparecen en sistemas de información. Cada componente está documentado con una estructura consistente de once campos, que permite entender qué hace, cómo se relaciona con otros componentes y qué partes del Tablero Digital materializa.
¿Qué es un componente?
En este catálogo, un componente es un tipo de funcionalidad recurrente definida por su propósito, no por su implementación técnica. Un "Mantenedor" cumple el mismo propósito ya sea implementado en Java, Python o cualquier otra tecnología: gestionar el ciclo de vida de una entidad de datos mediante operaciones de creación, lectura, actualización y eliminación.
Esto distingue a los componentes del catálogo de otras acepciones del término en ingeniería de software (como los componentes del modelo C4, que describen agrupaciones de código dentro de un contenedor). Los componentes del catálogo operan en el nivel funcional, cercano a los requisitos de software, y son comprensibles tanto para desarrolladores como para stakeholders de negocio.
¿Para quién es?
El catálogo está diseñado para ser utilizado por distintos perfiles durante las etapas tempranas de un proyecto:
- Desarrolladores y equipos técnicos que reconocen los componentes por su nombre funcional (CRUD, Dashboard, ETL) y necesitan entender qué implican en términos de esfuerzo, dependencias y cobertura del sistema.
- Jefes de proyecto y stakeholders que conocen los componentes por la necesidad que resuelven ("necesito mostrar datos en tiempo real", "necesito cargar datos masivamente") y necesitan evaluar opciones y comunicar requerimientos.
- Evaluadores y validadores que revisan la coherencia y completitud del catálogo como artefacto.
Estructura de cada componente
Cada componente se documenta con once campos, diseñados para capturar tanto sus características funcionales como su relación con el Tablero Digital:
| # | Campo | Qué describe |
|---|---|---|
| 1 | Alias | Nombres alternativos con que se conoce el componente en la industria |
| 2 | Descripción | Qué es el componente y cuál es su propósito principal |
| 3 | Capacidades mandatorias | Funcionalidades mínimas que debe tener para ser reconocido como tal |
| 4 | Capacidades adicionales | Funcionalidades que pueden enriquecerlo sin ser parte de su definición esencial |
| 5 | Delimitaciones | Qué no es y qué no incluye, para diferenciarlo de otros componentes |
| 6 | Flujo de información | Qué información recibe como entrada y qué produce como salida |
| 7 | Modalidades | Formas reconocibles en que puede presentarse |
| 8 | Dependencias típicas | Otros componentes con los que frecuentemente se relaciona |
| 9 | Ejemplos | Casos concretos en sistemas reales, con capturas de pantalla |
| 10 | Mapeo al Tablero Digital | Para cada sección del tablero, si el vínculo es mandatorio, opcional o no existe |
| 11 | Ejemplo de Tablero Digital | Representación concreta de cómo se distribuye en el tablero con tarjetas de ejemplo |
La distinción entre capacidades mandatorias y adicionales (campos 3 y 4) es particularmente importante: permite reconocer un mismo componente en sistemas con distintos grados de sofisticación. Un Mantenedor básico ofrece listar, crear, editar y eliminar registros; uno más avanzado puede incluir además exportación, filtros avanzados u ordenamiento por columnas. Ambos son instancias del mismo componente, pero con capacidades adicionales distintas.
Relación con el Tablero Digital
El catálogo y el Tablero Digital son herramientas complementarias:
- El Tablero Digital opera en el plano del propósito: sus secciones constituyen el vocabulario para declarar qué necesita el sistema.
- El catálogo opera en el plano de la materialización: provee el vocabulario para describir cómo se concreta lo que el tablero declara.
Un mismo componente puede tocar varias secciones del tablero a la vez. Por ejemplo, un Mantenedor siempre involucra Entradas Manuales (formularios de creación y edición), Conceptos de Datos (la entidad que gestiona) y Salidas por Demanda (listado y búsqueda de registros). Esta transversalidad es una propiedad fundamental del catálogo: los componentes no pertenecen a una sola sección del tablero.
El mapeo entre componentes y secciones se presenta en la matriz consolidada y en la ficha individual de cada componente.
Lo que el catálogo no es
Es tan importante entender qué ofrece el catálogo como qué no ofrece:
- No es un manual de implementación. No indica cómo construir un componente en un lenguaje o framework específico.
- No es un catálogo de patrones de diseño. No prescribe estructuras de código ni soluciones arquitectónicas.
- No es exhaustivo. Representa un conjunto acotado de componentes identificados como recurrentes. Los proyectos pueden requerir funcionalidades que no correspondan a ningún componente del catálogo.
Cómo usar el catálogo
El catálogo se puede recorrer de tres maneras, todas accesibles desde la barra de navegación:
- Por componente. La barra lateral lista los diecisiete componentes. Cada uno tiene su propia página con la ficha completa.
- Por sección del tablero. La matriz consolidada muestra qué componentes tocan cada sección, permitiendo responder preguntas como "¿qué componentes necesito si mi sistema tiene muchas entradas manuales?"
- Por tags. Los componentes se agrupan por afinidad funcional: autenticación, visualización, ingesta de datos, seguridad, entre otras.
Construcción y validación
El catálogo fue construido siguiendo un proceso iterativo que combinó:
- Conocimiento previo sobre desarrollo de sistemas de información
- Observación de sistemas existentes en contextos académicos e industriales
- Consulta de referencias técnicas y literatura especializada
- Validación empírica mediante el análisis detallado de sistemas de información reales
Cada componente fue refinado sucesivamente para delimitar sus características esenciales, diferenciarlo de componentes similares y documentar sus dependencias típicas.