Saltar al contenido principal

Sobre el Catálogo

El Catálogo de Componentes es una colección navegable de veintidós 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?

Definición operativa
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

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.
Busca: capacidades, dependencias típicas, modalidades de implementación.

Jefes de proyecto y stakeholders

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.
Busca: descripción, ejemplos concretos, mapeo al Tablero Digital.

Evaluadores y validadores

Revisan la coherencia y completitud del catálogo como artefacto, contrastando cada ficha contra la propuesta conceptual del trabajo de memoria.
Busca: consistencia estructural, delimitaciones claras, trazabilidad.

Estructura de cada componente

Cada componente se documenta con once campos, agrupados en cinco dimensiones que permiten entender qué es, cómo se comporta, y cómo se vincula con el Tablero Digital.

IdentidadCampos 1–2
1AliasNombres alternativos con que se conoce el componente en la industria.
2DescripciónQué es el componente y cuál es su propósito principal.
Capacidades y límitesCampos 3–5
3Capacidades mandatoriasFuncionalidades mínimas que debe tener para ser reconocido como tal.
4Capacidades adicionalesFuncionalidades que pueden enriquecerlo sin ser parte de su definición esencial.
5DelimitacionesQué no es y qué no incluye, para diferenciarlo de otros componentes.
ComportamientoCampos 6–8
6Flujo de informaciónQué información recibe como entrada y qué produce como salida.
7ModalidadesFormas reconocibles en que puede presentarse.
8Dependencias típicasOtros componentes con los que frecuentemente se relaciona.
EjemplosCampo 9
9EjemplosCasos concretos en sistemas reales, con capturas de pantalla.
Vínculo con el TableroCampos 10–11
10Mapeo al Tablero DigitalPara cada sección del tablero, si el vínculo es mandatorio, opcional o no existe.
11Ejemplo de Tablero DigitalRepresentació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 que operan en planos distintos.

Tablero Digital

El propósito

Sus secciones constituyen el vocabulario para declarar qué necesita el sistema. Cada tarjeta es una intención.
Catálogo

La materialización

Provee el vocabulario para describir cómo se concreta lo que el tablero declara. Cada componente es una unidad funcional reconocible.

Un mismo componente puede tocar varias secciones del tablero a la vez. Por ejemplo, un Mantenedor siempre involucra Actualización Manual (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

Calibrar expectativas

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.

El catálogo se puede recorrer de tres maneras, todas accesibles desde la barra de navegación.

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, y 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.

Estado actual
22 componentes documentados · estructura uniforme de 11 campos · mapeo explícito a las 6 secciones del Tablero Digital · navegación por tres ejes (componente, sección, etiquetas).