← Portfolio El proyecto
Capítulo 08

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.

ENTIDADES EXTERNASPROCESOSALMACENES DE DATOS solicitud ficha de cliente ficha completa condiciones y necesidades propuesta y cotización proyecto aceptado coordinación de obra condiciones de pago acordadas recibo de pago recibo proyecto finalizado legajo y planos entrega Cliente Diseñador, proveedor y cuadrilla Contacto del cliente Propuesta y cotización Inicio y condiciones de obra Cobro Entrega de legajo técnico Clientes Proyectos Cobros Legajo técnico
DFD de nivel 1: entidades externas, los cinco procesos del estudio y los almacenes de datos que dejan a su paso.

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.
CUENTASOPERACIÓN DE PROYECTOSADMINISTRACIÓN tiene varios genera Usuario Rol de usuario Cliente Dirección / Localidad / Provincia ★ Proyecto Estado de proyecto Tipología de proyecto Tipo de servicio Tipo de tarea ★ Tarea (Assignment) ★ Hub ★ Historial de proyecto ★ Presupuesto Estado de presupuesto ★ Cobro (Payment) Método de pago
DER (diagrama entidad-relación), agrupado en las mismas tres áreas del estudio que el diagrama de paquetes. Verde = entidad transaccional (★), tostado = entidad maestra.
EntidadAtributos principalesTipoSe relaciona con
UsuarioNombre, apellido, DNI, mail, teléfonoMaestra (con auditoría)Rol y Estado de usuario, Proyecto
Rol de usuarioDescripción: Admin, Usuario, Soporte, Técnico, VisitanteMaestraUsuario
ClienteNombre, apellido, DNI, mail, teléfono, direcciónMaestra (con auditoría)Rol y Estado de cliente, Dirección, Proyecto
Dirección / Localidad / ProvinciaCalle, número, piso, código postalMaestras (catálogo geográfico)Cliente
Proyecto ★Nombre, cliente, usuario responsable, presupuestoTransaccionalCliente, Usuario, Tipología, Estado de proyecto, Tipo de servicio, Tarea, Historial, Presupuesto
Estado de proyectoDescripción: Activo, Inactivo, En progreso, Completado, PendienteMaestraProyecto
Tipología de proyectoNombre, rango de superficie, honorario profesionalMaestraProyecto
Tipo de servicioNombre, si es privadoMaestraProyecto, Tipo de tarea
Tipo de tareaNombre, orden dentro del servicio (25 tareas estándar predefinidas)MaestraTarea, Tipo de servicio
Tarea (Assignment) ★Iniciada, completada, omitida u oculta, fecha de compromiso originalTransaccionalProyecto, Tipo de tarea, Hub
Hub ★Compromiso (fecha, nota) o mensaje o archivo adjunto de una tareaTransaccionalTarea
Historial de proyecto ★Fecha del cambio, estado alcanzadoTransaccional (bitácora)Proyecto
Presupuesto ★Superficie, costo por m², fecha de creación y vencimientoTransaccionalProyecto, Estado de presupuesto, Cobro
Estado de presupuestoDescripción: en Revisión, Finalizado, Aprobado, PagadoMaestraPresupuesto
Cobro (Payment) ★Monto, fecha de cobroTransaccionalPresupuesto, Método de pago
Método de pagoDescripción: Efectivo, Transferencia, DébitoMaestraCobro

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.

SESIÓN No autenticada login válido Autenticada cerrar sesión / expira PROYECTO Pendiente Activo En progreso ≥1 tarea completada u omitida Completado Inactivo condición no detallada en el legajo TAREA Pendiente Iniciada Completada Omitida se omite Oculta se retira del listado activo PRESUPUESTO En revisión Finalizado Aprobado Pagado Orden documentado en el DER (Estado de presupuesto); el legajo original no detalla quién dispara cada pasoni sus condiciones. COBRO Registrado motivo de anulación (RN-07) Anulado
Ciclo de vida de la sesión, el proyecto, la tarea, el presupuesto y el cobro: estados finales en verde, transiciones documentadas con su condición.

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

CampoTipo de datoObligatorioÚnicoEjemploDescripción en lenguaje del negocio
nombreVarchar(50)SíNoJulietaEl 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).
apellidoVarchar(50)SíNoFerreyraEl apellido de ese colaborador interno; se muestra siempre junto al nombre en las mismas pantallas.
número de usuarioInt (identity)SíSí2187El identificador que el sistema asigna solo al dar de alta; sirve para iniciar sesión junto con la contraseña.
DNIVarchar(10)SíSí29.874.512Ademá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éfonoVarchar(100) / Varchar(20)SíNojulieta.ferreyra@mgdarquitectura.com / 351-445-2290Los dos datos de contacto que, junto al DNI, el sistema valida para recuperar la contraseña.
rolInt (FK a Rol de usuario)SíNo3 (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

CampoTipo de datoObligatorioÚnicoEjemploDescripción en lenguaje del negocio
nombreVarchar(50)SíNoBraianEl 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.
apellidoVarchar(50)SíNoQuirogaEl apellido del cliente; se muestra siempre junto al nombre en las mismas pantallas.
número de clienteInt (identity)SíSí3654El identificador que el sistema asigna al dar de alta al cliente; junto con la contraseña, habilita el acceso al Portal del cliente.
DNIVarchar(10)SíSí31.208.677Igual que en Usuario, es también la contraseña provisoria al recuperar el acceso.
direcciónInt (FK a Dirección)NoNo58 (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

CampoTipo de datoObligatorioÚnicoEjemploDescripción en lenguaje del negocio
nombreVarchar(100)SíNoAmpliación vivienda unifamiliar, Bº CerroCó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.
clienteInt (FK a Cliente)SíNo3654 (Braian Quiroga)Quién encargó y paga el proyecto. Un mismo cliente puede tener varios proyectos con el estudio a la vez.
tipologíaInt (FK a Tipología de proyecto)SíNo2 (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.
estadoInt (FK a Estado de proyecto)SíNo3 (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.
presupuestoDecimal(18,2)NoNo$7.850.000El 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 responsableInt (FK a Usuario)SíNo2187 (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

CampoTipo de datoObligatorioÚnicoEjemploDescripción en lenguaje del negocio
montoDecimal(18,2)SíNo$320.000Lo efectivamente cobrado en ese pago puntual, no el presupuesto total del proyecto.
fecha de cobroDateSíNo02/07/2025Cuándo se recibió el pago, no cuándo se acordó ni cuándo vence.
medio de pagoInt (FK a Método de pago)SíNo1 (Efectivo)Cómo entró la plata; alimenta los reportes de distribución por medio de pago del capítulo Funcionalidades.
vencimientoDateNo (solo si el cobro está pendiente)No18/07/2025La 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ónVarchar(200)No (solo si el cobro se anula)NoTransferencia rechazada por error de CBUPor 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.