Modelado
El flujo de datos, el modelo de datos, la transición de estados y el diccionario que lo traduce a lenguaje de negocio.
8.1Diagrama de flujo de datos (DFD)
El legajo original no relevó un DFD como artefacto propio: lo que sigue se reconstruye a partir de los cinco procesos ya documentados en el capítulo de Relevamiento (participantes, evento de inicio y documentos generados de cada uno), leídos en notación de flujo de datos en vez de BPMN.
8.2Modelo de datos (DER)
El modelo completo tiene más tablas que las cuatro entidades centrales (Usuario, Cliente, Proyecto, Tipología): una decena de catálogos (roles, estados, métodos de pago, tipos de servicio y tarea, geografía) las sostienen. Maestras: existen antes de que pase algo. Transaccionales (★): registran que algo pasó, con fecha y estado propio.
- Un Cliente puede tener varios Proyectos, y cuelga de un catálogo geográfico propio (Dirección, Localidad, Provincia).
- Cada Proyecto tiene una Tipología (clasificación fija: anteproyecto, con detalle o gestión y conducción de obra) y, por separado, un Estado de flujo propio (Activo, Inactivo, En progreso, Completado o Pendiente) que si avanza queda registrado en su Historial.
- Cada Proyecto agrupa los Servicios contratados, y cada Servicio se descompone en Tareas predefinidas por su tipo.
- Cada Tarea puede tener uno o más registros de Hub colgando de ella: un compromiso, un mensaje o un archivo adjunto, visible tanto para el usuario interno como para el cliente.
- Cada Proyecto tiene un Presupuesto con su propio estado de aprobación (en revisión, finalizado, aprobado, pagado), y los Cobros se registran contra ese presupuesto, cada uno con su medio de pago.
| Entidad | Atributos principales | Tipo | Se relaciona con |
|---|---|---|---|
| Usuario | Nombre, apellido, DNI, mail, teléfono | Maestra (con auditoría) | Rol y Estado de usuario, Proyecto |
| Rol de usuario | Descripción: Admin, Usuario, Soporte, Técnico, Visitante | Maestra | Usuario |
| Cliente | Nombre, apellido, DNI, mail, teléfono, dirección | Maestra (con auditoría) | Rol y Estado de cliente, Dirección, Proyecto |
| Dirección / Localidad / Provincia | Calle, número, piso, código postal | Maestras (catálogo geográfico) | Cliente |
| Proyecto ★ | Nombre, cliente, usuario responsable, presupuesto | Transaccional | Cliente, Usuario, Tipología, Estado de proyecto, Tipo de servicio, Tarea, Historial, Presupuesto |
| Estado de proyecto | Descripción: Activo, Inactivo, En progreso, Completado, Pendiente | Maestra | Proyecto |
| Tipología de proyecto | Nombre, rango de superficie, honorario profesional | Maestra | Proyecto |
| Tipo de servicio | Nombre, si es privado | Maestra | Proyecto, Tipo de tarea |
| Tipo de tarea | Nombre, orden dentro del servicio (25 tareas estándar predefinidas) | Maestra | Tarea, Tipo de servicio |
| Tarea (Assignment) ★ | Iniciada, completada, omitida u oculta, fecha de compromiso original | Transaccional | Proyecto, Tipo de tarea, Hub |
| Hub ★ | Compromiso (fecha, nota) o mensaje o archivo adjunto de una tarea | Transaccional | Tarea |
| Historial de proyecto ★ | Fecha del cambio, estado alcanzado | Transaccional (bitácora) | Proyecto |
| Presupuesto ★ | Superficie, costo por m², fecha de creación y vencimiento | Transaccional | Proyecto, Estado de presupuesto, Cobro |
| Estado de presupuesto | Descripción: en Revisión, Finalizado, Aprobado, Pagado | Maestra | Presupuesto |
| Cobro (Payment) ★ | Monto, fecha de cobro | Transaccional | Presupuesto, Método de pago |
| Método de pago | Descripción: Efectivo, Transferencia, Débito | Maestra | Cobro |
8.3Transición de estados (DTE)
Cómo cambian de estado a lo largo del tiempo cinco de las entidades transaccionales del modelo: la sesión de quien usa el sistema, el proyecto, la tarea, el presupuesto y el cobro.
Sesión: No autenticada → Autenticada con login válido, y de vuelta al cerrar sesión o expirar. Usuario interno y Cliente tienen flujos separados, con distinto subconjunto de pantallas.
Tipología de proyecto (Anteproyecto, Proyecto con detalle, Gestión y conducción de obra) es una etiqueta fija, no transiciona. Estado de proyecto sí es una máquina de estados (Pendiente, Activo, En progreso, Completado, Inactivo): el pase a Completado exige que al menos una tarea quede completada u omitida. Todo cambio de estado, salvo el pase a Pendiente, queda en el Historial del proyecto.
Tarea: Pendiente → Iniciada → Completada, Omitida u Oculta (retirada del listado activo sin eliminarse). Alimenta el gráfico de avance del capítulo Requerimientos.
Presupuesto y Cobro también tienen estado propio (ver DER, entidades marcadas ★): el presupuesto pasa por revisión, finalización, aprobación y pago, y un cobro registrado puede anularse con motivo (ver RN-07 en el Catálogo de reglas de negocio de Organización). El legajo original no detalla el disparador exacto de cada paso del presupuesto, así que ese tramo queda marcado como tal en el diagrama, en vez de completarlo con una regla inventada.
8.4Diccionario de datos
La traducción entre lo que dice la base de datos y lo que dice el estudio: las cuatro entidades más centrales del sistema, campo por campo, en lenguaje de negocio. Las entidades de catálogo (roles, estados, tipologías) no se repiten acá porque ya están descriptas en la tabla del DER.
Usuario
| Campo | Tipo de dato | Obligatorio | Único | Ejemplo | Descripción en lenguaje del negocio |
|---|---|---|---|---|---|
| nombre | Varchar(50) | Sí | No | Julieta | El nombre de pila de ese colaborador interno; junto con el apellido identifica al usuario en cada pantalla donde aparece (asignaciones, historial, contacto para el cliente). |
| apellido | Varchar(50) | Sí | No | Ferreyra | El apellido de ese colaborador interno; se muestra siempre junto al nombre en las mismas pantallas. |
| número de usuario | Int (identity) | Sí | Sí | 2187 | El identificador que el sistema asigna solo al dar de alta; sirve para iniciar sesión junto con la contraseña. |
| DNI | Varchar(10) | Sí | Sí | 29.874.512 | Además de identificar a la persona, es la contraseña provisoria que el sistema asigna al recuperar el acceso (ver Catálogo de reglas de negocio). |
| correo y teléfono | Varchar(100) / Varchar(20) | Sí | No | julieta.ferreyra@mgdarquitectura.com / 351-445-2290 | Los dos datos de contacto que, junto al DNI, el sistema valida para recuperar la contraseña. |
| rol | Int (FK a Rol de usuario) | Sí | No | 3 (Técnico) | Qué puede hacer ese usuario dentro del sistema; un mismo usuario puede tener más de un rol a la vez (ver Organización, Actores del negocio). |
Cliente
| Campo | Tipo de dato | Obligatorio | Único | Ejemplo | Descripción en lenguaje del negocio |
|---|---|---|---|---|---|
| nombre | Varchar(50) | Sí | No | Braian | El nombre de pila con el que el estudio identifica a ese cliente; junto con el apellido es lo que ve el socio a cargo al abrir cualquiera de sus proyectos. |
| apellido | Varchar(50) | Sí | No | Quiroga | El apellido del cliente; se muestra siempre junto al nombre en las mismas pantallas. |
| número de cliente | Int (identity) | Sí | Sí | 3654 | El identificador que el sistema asigna al dar de alta al cliente; junto con la contraseña, habilita el acceso al Portal del cliente. |
| DNI | Varchar(10) | Sí | Sí | 31.208.677 | Igual que en Usuario, es también la contraseña provisoria al recuperar el acceso. |
| dirección | Int (FK a Dirección) | No | No | 58 (Bv. Illia 1200, Córdoba) | El domicilio del cliente, apoyado en el catálogo geográfico (Dirección, Localidad, Provincia); no es la dirección de la obra, que se registra por proyecto. |
Proyecto
| Campo | Tipo de dato | Obligatorio | Único | Ejemplo | Descripción en lenguaje del negocio |
|---|---|---|---|---|---|
| nombre | Varchar(100) | Sí | No | Ampliación vivienda unifamiliar, Bº Cerro | Cómo identifica el estudio a ese proyecto puntual; no es un código interno, es el nombre por el que se lo reconoce en una conversación. |
| cliente | Int (FK a Cliente) | Sí | No | 3654 (Braian Quiroga) | Quién encargó y paga el proyecto. Un mismo cliente puede tener varios proyectos con el estudio a la vez. |
| tipología | Int (FK a Tipología de proyecto) | Sí | No | 2 (Gestión y conducción de obra) | En qué etapa de trabajo está el proyecto. No es lo mismo que el estado: la tipología no cambia sola, se reclasifica cuando el cliente avanza de etapa. |
| estado | Int (FK a Estado de proyecto) | Sí | No | 3 (Activo) | Dónde está el proyecto en su flujo real de trabajo. Cambia solo por reglas del sistema (ver Catálogo de reglas de negocio), nunca se edita a mano. |
| presupuesto | Decimal(18,2) | No | No | $7.850.000 | El monto acordado con el cliente, contra el cual se registran los cobros. No incluye estudio de suelo ni costos administrativos, según la política de producción del estudio. |
| usuario responsable | Int (FK a Usuario) | Sí | No | 2187 (Julieta Ferreyra) | El socio del estudio a cargo del proyecto; es el arquitecto que el cliente ve como su contacto en el Portal del cliente. |
Cobro
| Campo | Tipo de dato | Obligatorio | Único | Ejemplo | Descripción en lenguaje del negocio |
|---|---|---|---|---|---|
| monto | Decimal(18,2) | Sí | No | $320.000 | Lo efectivamente cobrado en ese pago puntual, no el presupuesto total del proyecto. |
| fecha de cobro | Date | Sí | No | 02/07/2025 | Cuándo se recibió el pago, no cuándo se acordó ni cuándo vence. |
| medio de pago | Int (FK a Método de pago) | Sí | No | 1 (Efectivo) | Cómo entró la plata; alimenta los reportes de distribución por medio de pago del capítulo Funcionalidades. |
| vencimiento | Date | No (solo si el cobro está pendiente) | No | 18/07/2025 | La fecha límite acordada para un cobro todavía no recibido; dispara la alerta cuando se acerca sin cobrarse (ver Catálogo de reglas de negocio). |
| motivo de anulación | Varchar(200) | No (solo si el cobro se anula) | No | Transferencia rechazada por error de CBU | Por qué se dio de baja un cobro ya registrado; el cobro anulado no vuelve a contarse en el saldo del proyecto, pero el motivo queda como evidencia (ver Catálogo de reglas de negocio). |
Con los datos y sus transiciones ya modelados, cómo se traducen en clases, capas de código y despliegue es el tema del capítulo siguiente: Diseño.