Sistema de Gestión Personas

Entidades

Entidad	Descripción
Persona	Contiene los datos básicos de una persona
DatosPersonales	Contiene los datos personales de una persona (datos nacimiento de la persona)
DatosContacto	Contiene los datos de contacto de una persona (dirección de contacto, teléfonos, emil, etc.)
DatosAcademicos	Contiene los datos académicos, por el momento, únicamente se necesita el nivel académico
Vinculacion	Contiene los datos de vinculación de una persona a la estructura organizativa Universitaria
TipoDocumento	Listado con los tipos de documento de identificación (NIF/NIE/Pasaporte)
Sexo	Listado con los valores que puede tomar la entidad sexo (Mujer/Hombre). Se necesita un mapeo con los valores de la Fecyt para poder mostrarlo en el módulo CVN. Se tomará como id los códigos de la Fecyt.
Email	Contiene los email de una persona (el de la universidad, el personal, etc)
Telefono	Contiene los teléfonos de una persona (móvil, fijo, fax, etc)
CategoriaProfesional	Listado con las categorías profesionales de la Universidad (RELACIONES VIGENTES UM.xlsx)
SubcategoriaProfesional	Una clasificación dentro de la categoría profesional. Es una subclasificación de la categoría profesional. Por ejemplo una persona que tiene categoría profesional PDI Numerario, se puede clasificar en: catedrático de universidad, titular de universidad, profesor ayudante y/o profesor
NivelAcademico	Listado con los niveles académicos (Doctor, Ldo/Graduado, Diplomado, FP, etc)
Colectivo	Listado de colectivos que tiene la Universidad, sirvan como ejemplos de colectivos "personal de investigación", "personal de administración" ,"alumnos". Agrupación de personas sobre las que se van a realizar las búsquedas de personas.
ColectivoTipoColectivo	Relaciona los colectivos con el enumerado interno del SGI "TipoColectivo". En las búsquedas de personas de los distintos módulos del SGI se podrán buscar personas sobre varios colectivos o sobre un "TipoColectivo". Un "TipoColectivo" estará relacionado con varios colectivos. Por ejemplo se puede tener como "TipoColectivo" evaluador ética, donde los colectivos que lo forman son PDI y Alumnos 5 ciclo. Por lo que al buscar personas para que sean el evaluador de ética se filtrarán por aquellas que sean PDI o sean Alumnos de 5 ciclo.
ColectivoCategoriaProfesional	Define que categorías profesionales pertenecen a cada uno de los colectivos definidos en la Universidad. En categoría profesionales, podemos tener" PAS FIJO/INDEFINIDO" , "PAS CONTRATADO", "PAS CENTROS ADSCRITOS"

Modelo lógico

API

Características generales que todas las API REST deben de cumplir:

Consultas filtradas y paginadas

Definición de los objetos

Persona

Nombre	Tipo	Descripción
personaRef	String	Identificador de la persona
nombre	String	Nombre de la persona
apellidos	String	Apellidos de la persona
sexo	Sexo	Se devuelve la entidad Sexo con todos sus campos
numeroDocumento	String	Número de documento de identificación personal
tipoDocumento	TipoDocumento	Se devuelve la entidad TipoDocumento con todos sus campos

Persona

{
    "personaRef": "ent-002",
    "nombre": "Prueba",
    "apellidos": "Apellido1 Apellido2",
    "sexo": {
          "id":"sex-1",
          "nombre":"Mujer"
     },
    "numeroIdentificacion": "11111111H",
    "tipoDocumento": {
            "id":"tp-1",
            "nombre": "NIF"
       }
}

Sexo

Nombre	Tipo	Descripción
id	String	Identificador de la entidad Sexo
nombre	String	Nombre (Posibles valores: Mujer, Hombre)

Sexo

{
   "id":"sex-1",
   "nombre":"Mujer"  
}

TipoDocumento

Nombre	Tipo	Descripción
id	String	Identificador de la entidad TipoDocumento
nombre	String	Nombre (Posibles valores: NIF, NIE, Pasaporte)

TipoDocumento

{ 
    "id":"tp-1",
    "nombre": "NIF"   
}

DatosPersonales

Nombre	Tipo	Descripción
fechaNacimiento	String	Fecha de nacimiento de la persona
paisNacimiento	String	Se devuelve la entidad Pais con todos sus campos. Ver definición en SGI - ESB - SGO
comAuntonomaNacimiento	String	Se devuelve la entidad ComunidadAutonoma con todos sus campos. Ver definición en SGI - ESB - SGO
ciudadNacimiento	String	Ciudad de nacimiento de la persona

DatosPersonales

{
    "fechaNacimiento": "2000-02-10",
    "paisNacimiento": {
       "id":"33",
       "nombre":"España"
     },
    "comAuntonomaNacimiento": {
       "id":"ca-1",
       "nombre":"Andalucía"
     }, 
    "ciudadNacimiento": "Sevilla"
    
}

DatosContacto

Nombre	Tipo	Descripción
paisContacto	String	Se devuelve la entidad Pais con todos sus campos. Ver definición en SGI - ESB - SGO
comAuntonomaContacto	String	Se devuelve la entidad ComunidadAutonoma con todos sus campos. Ver definición en SGI - ESB - SGO
provinciaContacto	String	Se devuelve la entidad Provincia con todos sus campos. Ver definición en SGI - ESB - SGO
ciudadContacto	String	Ciudad de contacto de la persona
direccionContacto	String	Dirección de contacto de la persona
codigoPostalContacto	String	Código postal de la dirección de contacto de la persona
emails	Lista[String]	Lista con los email de la persona
telefonos	Lista[String]	Lista con los teléfonos de la persona

DatosContacto

{
    "paisContacto": {
       "id":"33",
       "nombre":"España"
     },
    "comAuntonomaContacto": {
       "id":"ca-3",
       "nombre":"Asturias"
     }, 
    "provinciaContacto": {
       "id":"pro-1",
       "nombre":"Asturias"
     }, 
	"ciudadContacto": "Oviedo",
	"direccionContacto": "C/ Uria número 4, puerta A",
	"codigoPostalContacto": "33005"    
    "emails":["prueba@prueba.es","prueba2@prueba.es"],
    "telefonos":["985112233","699445566"]  		
}

Vinculacion

Nombre	Tipo	Descripción
categoriaProfesional	CategoriaProfesional	Se devuelve la entidad CategoriaProfesional con todos sus campos
fechaObtencionCategoria	String	Fecha en la que se obtiene la categoría profesional
subcategoriaProfesional	SubcategoriaProfesional	Se devuelve la entidad SubcategoriaProfesional con todos sus campos
departamento	Departamento	Se devuelve la entidad Departamento con todos sus campos. Ver definición en SGI - ESB - SGO
areaConocimiento	AreaConocimiento	Se devuelve la entidad AreaConocimiento con todos sus campos. Ver definición en SGI - ESB - SGO
empresa	Empresa	Se devuelve la entidad Empresa con los datos básicos. Ver definición en SGI - ESB - SGEMP

Vinculacion

{
    "categoriaProfesional":{
       "id":"catp-1",
       "nombre":"PDI Numerario"
     },
    "fechaObtencionCategoria":"2020-03-15",
    "subcategoriaProfesional": {
       "id":"cupro-1",
       "nombre":"Profesor"
     },
    "departamento": {
       "id":"dpt-1",
       "nombre":"Departamento Ciencias de la tecnología"
     },
    "areaConocimiento": {
       "id":"ac-1",
       "nombre":"Área de conocimiento A"
     },
    "empresa": {
       "id":"emp-1",
       "nombre":"Universidad de Murcia"
     }
}

CategoriaProfesional

Nombre	Tipo	Descripción
id	String	Identificador de la entidad CategoriaProfesional
nombre	String	Nombre de la categoría profesional de la persona dentro de la universidad.(RELACIONES VIGENTES UM.xlsx)

CategoriaProfesional

{
   "id":"catp-1",
   "nombre":"PDI Numerario"
}

SubcategoriaProfesional

Nombre	Tipo	Descripción
id	String	Identificador de la entidad SubcategoriaProfesional
nombre	String	Es una subclasificación de la categoría profesional. Por ejemplo una persona que tiene categoría profesional PDI Numerario, se puede clasificar en: catedrático de universidad, titular de universidad, profesor ayudante y/o profesor

SubcategoriaProfesional

{ 
   "id":"cupro-1",
   "nombre":"Profesor" 
}

DatosAcademicos

Nombre	Tipo	Descripción
nivelAcademico	NivelAcademico	Se devuelve la entidad NivelAcademico con todos sus campos.
fechaObtencion	String	Fecha obtención del nivel académico.

DatosAcademicos

{
    "nivelAcademico": {
       "id":"1",
       "nombre":"Doctorado",
       "codigoFecyt":"940"
     },
     "fechaObtencion":"2000-02-10"
}

NivelAcademico

Nombre	Tipo	Descripción
id	String	Identificador de la entidad NivelAcademico
nombre	String	Nombre del NivelAcademico (Posibles valores: Doctor, Ldo/Graduado, Diplomado, FP, etc)
codigoFecyt	String	Codigo en la norma Fecyt que se corresponde con el nivel académico del SGI

NivelAcademico

{
       "id":"1",
       "nombre":"Doctorado",
       "codigoFecyt":"940"  
}

Colectivo

Nombre	Tipo	Descripción
id	String	Identificador de la entidad Colectivo
nombre	String	Nombre del colectivo (Posibles valores: PAS, PSI, Alumnos, Becarios, Externo)

Colectivo

{
    "id":"1",
    "nombre":"PDI"
}

Fotografia

Nombre	Tipo	Descripción
contenido	String	Contenido de la fotografía digital de la persona (en bytes y en base 64)
mimeType	String	Mimetype de la fotogracía

Fotografia

{
    "contenido":"DDfgdfgdfj46gd6f5gdfgdf=",
    "mimeType":"image/jpeg"
}

Servicios

Método	URL	Parámetros	Respuesta	Descripción
GET	/personas	q+s (query + sort) La query estará formada por: tipoColectivo colectivoRef nombre apellidos numeroDocumento personaRef	Lista[Persona]	Listado de Persona. Ejemplo: colectivoRef=in=(refPAS,refPDI);(nombre=like=11111111H,apellidos=like=11111111H,numeroDocumento=like=11111111H) Nota: tipoColetivo y colectivoRef son mutuamente excluyentes. En el caso se recibir un tipoColectivo se traducirá a los colectivos que lo formen.
GET	/personas/{personaRef}	personaRef	Persona	Detalle de los datos generales de una persona
POST	/personas	JSON		Recibe como parámetro la respuesta del usuario del formulario de datos básicos (formly) con los campos necesarios para crear una persona

GET	/datos-personales/persona/{personaRef}	personaRef	DatosPersonales	Detalle de los datos personales de una persona (datos de dirección, nacimiento, etc)
POST	/datos-personales	JSON		Recibe como parámetro la respuesta del usuario del formulario de datos personales (formly) con los campos necesarios para crear la entidad de datos personales de una persona. En el formulario se deben de incluir el campo personaRef para saber de quien se trata (campo oculto)

GET	/datos-contacto/persona/{personaRef}	personaRef	DatosContacto	Contiene la lista de email y/o de teléfonos de una persona
POST	/datos-contacto	JSON		Recibe como parámetro la respuesta del usuario del formulario de datos contacto (formly) con los campos necesarios para crear los datos de contacto de una persona. En el formulario se deben de incluir el campo personaRef para saber de quien se trata (campo oculto)

GET	/vinculaciones/persona/{personaRef}	personaRef	Vinculacion	Detalle de los datos de vinculación de una persona
POST	/vinculaciones	JSON		Recibe como parámetro la respuesta del usuario del formulario de vinculación (formly) con los campos necesarios para crear la vinculación de la universidad de la persona. En el formulario se deben de incluir el campo personaRef para saber de quien se trata (campo oculto)

GET	/datos-academicos/persona/{personaRef}	personaRef	DatosContacto	Contiene el nivel académico de la persona
POST	/datos-academicos	JSON		Recibe como parámetro la respuesta del usuario del formulario de datos académicos (formly) con los campos necesarios para crear los datos académicos de una persona. En el formulario se deben de incluir el campo personaRef para saber de quien se trata (campo oculto)

GET	/colectivos		Lista[Colectivo]	Listado de colectivos ordenados alfabéticamente de forma ascendente

GET	/tipo-documentos		Lista[TipoDocumento]	Listado de tipos de documento de identificación personal ordenados alfabéticamente de forma ascendente

GET	/categoria-profesionales		Lista[CategoriaProfesional]	Listado de categorías profesionales ordenados alfabéticamente de forma ascendente

GET	/subcategoria-profesionales/{idCategoria}	idCategoria	Lista[SubcateroriaProfesional]	Listado de subcategorías profesionales vinculadas a la categoría pasado por parámetro ordenados alfabéticamente de forma ascendente

GET	/nivel-academicos		Lista[NivelAcademico]	Listado de niveles académicos ordenados alfabéticamente de forma ascendente

GET	/personas/{personaRef}/fotografia		Fotografia	Detalle de la fotografía digital de la persona

Árbol de páginas

UM - SGI - ESB - SGP