Un desglose de la estructura de Agencias, Sitios, Servicios y Recursos dentro de la aplicación CS Resource.
Estructura Jerárquica
Al profundizar en resource, los componentes centrales (entidades y relaciones) se entienden mejor de forma jerárquica:
Organización (Su Organización)
└── Agencia (Proveedores de servicios listados en su base de datos)
├── Sitio
│ └── Servicio
└── Servicio
└── Recurso (Sitio + Servicio)
Identidad Principal: id, name, description, alias
Información de la Organización: organizationId, agencyType, legalStatus, status
Financiero: annualBudget, federalEIN, irsTaxCode, yearIncorporated
Liderazgo: directorName, directorTitle
Relaciones: parentAgency, sites[], services[]
Información de Contacto: addresses[], emails[], phones[], contactPersons[]
Otros: url, hour, references[], metadata
Sitio (Total: ~25+ campos)
Identidad Principal: id, name, description, alias
Relaciones: organizationId, agencyId, agency (anidada)
Estado: estado
Información de Contacto: addresses[], emails[], phones[], contactPersons[]
Otros: url, hour, references[], annotations[], metadata
Servicio (Total: ~30+ campos)
Identidad Principal: id, name, description, alias
Relaciones: organizationId, agencyId
Clasificación: airsTaxonomyId, metadata.airsTaxonomy
Estado: estado
Geográfico: areaGeografica
Legado: metadata.serviceNeed (obsoleto)
Información de Contacto: emails[], phones[], contactPersons[]
Otros: hour, references[], annotations[], metadata
Recurso (Total: ~35+ campos)
Identidad Principal: id, description, alias
Relaciones: organizationId, serviceId, siteId, agencyId
Objetos Anidados: service (completo), site (completo), site.agency (completo), organization
Estado: status, visibility, limitedAvailability
Área de Servicio: metadata.serviceAreaName[], metadata.serviceAreaRegion[], metadata.serviceAreaZipCodes[]
Detalles del Servicio: metadata.fees, metadata.applicationProcedure, metadata.serviceRequirements, metadata.serviceExclusions, metadata.serviceConditions
Información de Contacto: addresses[], emails[], phones[], contactPersons[]
Otros: hour, references[], networks[], area (null)
Matriz de Relaciones Detallada
1. Organización → Agencia
Tipo: Uno a Muchos
Restricción: Cada agencia pertenece exactamente a una organización
Ejemplo: La organización "211 Los Angeles" tiene la agencia "Homeless Services Network"
2. Agencia → Sitio
Tipo: Uno a Muchos
Restricción: Cada sitio pertenece exactamente a una agencia
Ejemplo: "Homeless Services Network" tiene los sitios "Downtown Shelter" y "Westside Outreach"
3. Agencia → Servicio
Tipo: Uno a Muchos
Restricción: Los servicios deben pertenecer a una agencia
Ejemplo: "Homeless Services Network" ofrece los servicios "Emergency Shelter" y "Food Assistance"
4. Sitio → Servicio
Tipo: Uno a Muchos
Restricción: Los servicios pueden pertenecer a un sitio
Nota: Los servicios pertenecen a una agencia, pero pueden ser específicos de un sitio
Ejemplo: El sitio "Downtown Shelter" ofrece el servicio "Emergency Shelter"
5. Servicio → Recurso
Tipo: Uno a Muchos
Restricción: Los recursos requieren la combinación sitio + servicio
Fórmula: Recurso = Sitio + Servicio
Ejemplo: El servicio "Emergency Shelter" en el sitio "Downtown Shelter" crea un recurso
Sitio → Recurso (vía referencias)
Tipo: Uno a Muchos
Relación: Los recursos referencian el sitio vía sitioId
Nota: El sitio es requerido para la creación del recurso
Lógica de Herencia entre entidades
Los campos heredados siguen la estructura jerárquica en el sentido de que solo las entidades inferiores pueden heredar información de las entidades de nivel superior. Los campos heredables, en cada nivel de entidad, pueden verse en el diagrama a continuación:
Diagrama Visual de Relaciones
Nota sobre el Diagrama: Cada entidad tiene un conjunto mínimo de campos requeridos para la creación. El diagrama muestra tanto los campos heredados como los campos mínimamente requeridos para la creación de la entidad.
