BITácora de Software

• Función Valida: La función Valida (valga la redundancia), lo siguiente:
• El campo que contiene el ID del médico y paciente debe tener asignado un valor.
• La fecha de atención debe tener asignado un valor.
• La hora inicio y hora fin de atención debe tener asignado un valor. además la hora de inicio no puede ser mayor o igual a la hora fin (línea 50 y 51).
• Se válida que el médico tenga horario disponible en la fecha de atención (hora inicio y fin)(Línea 57 a 60).
•  Una vez que se válida que el médico tiene horario disponible se procede a validar que no exista cruce con otra cita médica (Línea 62 a 68).
• Función GrabarCita: Al igual que con las funciones de registrar/editar de los cruds, la función registra la cita, simplemente hace un llamado a la función valida y realiza las verificaciones explicadas líneas arriba, una vez que se haya pasado dicha verificación se realiza la acción de registrar/editar según corresponda (si el id de la cita tiene como valor "-1" significa que la acción a tomar es registrar, en caso contrario se realiza la acción de editar)

Capa Presentación: Vista

Capa Presentación: Funcionalidad JS

1. ObtenerParametros: Leer el valor del input hidden medicoId y lo almacena en la variable global que tiene el mismo nombre. Además, hace lo mismo con el input hidden fechaAtencion como el dato esta en formato AAAAMMDD, al almacenarlo en la variable global lo guarda en formato DD/MM/AAAA.
2. ListarDatos: Sirve para invocar al web method que traer el horario y citas registradas para el médico en la fecha de atención indicada.
3. ObtenerCita: Recibe como parámetro el id de la cita a buscar, dicho parámetro es enviado a la función "ObtenerCita" del controlador y carga la información obtenida en el modal de la Cita.
4. ConfigurarCalendario: Esta función permite configurar el plugin fullcalendar. Asignamos la fecha actual al plugin para que cuando se dibuje el calendario muestre el mes/semana/día actual además se configura los botones que se van a mostrar y  por último se asigna la función que será invocada cuando se haga click en las celdas del calendario (línea 81). el objeto calEvent es el encargado de llevar la información del horario por ello accedemos a la propiedad calEvent.citaId con el fin de obtener el ID de la cita a modificar.
5. LimpiarDatosFormulario: Limpia los valores ingresados en los controles de la ventana modal.
6. NuevaCita: Invoca a la función LimpiarDatosFormulario y muestra el modal para ingresar la información de la cita.
7. Cancelar: Oculta el modal de Horario.
8. RecogerDatosFormulario: Esta función recoge los datos escritos en el formulario modal y lo inserta dentro de la variable cita.
9. Guardar: Invoca a la función RecogerDatosFormulario y luego envía la información de la cita a la función "GrabarCita" del controlador, al final la función retornará un objeto del tipo RespuestaSistema el cual contiene la propiedad Correcto, si esa propiedad es devuelta en true, entonces quiere decir que se ha grabado o modificado con éxito la cita.
10. AutocompletarPaciente: Esta función permite mostrar una lista con los pacientes que coinciden con el texto ingresado en la caja de texto (txtDni) que invoca a la función. Esta función tiene dos parámetros de entrada el primero es "control" que hace referencia al textbox que invoca la función y el segundo parámetro es la cantidad minima de caracteres que se necesitan para invocar a la función de búsqueda interna. La lista se arma dependiendo de los valores que devuelva la función "BuscarPaciente" del controlador cita.
11. MarcarMenu: Sirve para mantener seleccionado las opciones en el menú principal del sistema.
12. Inicio: Invoca a función MarcarMenu y ObtenerParametros, asigna las funciones a los eventos de los botones, asigna el plugin datepicker a la caja de texto de fecha del modal cita, crea el modal de la cita, configura el calendario, obtiene el el horario y las citas programadas del médico (para una fecha de atención) y finalmente muestra el contenido de la página. 

[Repositorio]

• Función Valida: La función Valida (valga la redundancia), lo siguiente:
• El campo que contiene el ID del médico debe tener asignado un valor, no se puede registrar un horario si no se tiene seleccionado un médico.
• La fecha de atención debe tener asignado un valor.
• La hora inicio y hora fin de atención debe tener asignado un valor. además la hora de inicio no puede ser mayor o igual a la hora fin (línea 41 y 42).
• Por otro lado, también se valida que no exista cruces con los horarios asignado al médico (línea 44 a 55).
• Función GrabarHorario: Al igual que con las funciones de registrar/editar de los cruds, la función registrar horario simplemente hace un llamado a la función valida y realiza las verificaciones explicadas líneas arriba, una vez que se haya pasado dicha verificación se realiza la acción de registrar/editar según corresponda (si el id del horario tiene como valor "-1" significa que la acción a tomar es registrar, en caso contrario se realiza la acción de editar)

• medicoId: Almacena el Identificador (PK) del médico, con este dato podemos obtener su información (nombres y apellidos), además de su horario de atención que será mostrado en el calendario.
• horario: sirve para contener la información que se enviará y/o traerá del horario a registrar/editar. Para este caso el horario se registra por día, es decir que si se desea registrar el horario del médico para toda una semana (Lunes - Viernes) se tiene que realizar 5 registros.
• model: contiene las funciones que permiten interactuar al usuario con la vista.

• Función Valida: Internamente invoca a la función ListarMedicos (línea 54) que devuelve el listado de médicos registrados activos, a dicha lista se le aplica linq para filtrar aquellos médicos que tengan el mismo DNI e ID distinto del médico a registrar o modificar, si se obtiene un registro que cumpla esas condiciones (línea 55) entonces quiere decir que el DNI ya fue asignado a otro médico por lo que se le notifica por medio del un mensaje de error (línea 56). Por otro lado, se tiene la validación de la lista de especialidades (línea 62) del médico, esta lista debe contar con al menos 1 registro, en caso no tenga datos asignado se mostrará un mensaje de error (línea 98). Si la lista de especialidades cuenta con registros, por cada registro de la lista (línea 66) se valida que el objeto contenga un ID (línea 70) y nombre (línea 75), además que dicha especialidad no se repita en la lista (línea 86).
• Función GrabarMedico: Esta función contiene un bloque transaccional para la inserción del detalle por médico (lista de especialidades) realizando un registro a la vez, en caso exista un error se realizará un rollback a todas las operaciones. Lo primero a realizar es la acción de validación del objeto (línea 127) una vez pase esta validación lo que continua es verificar su ID, si dicho ID contiene el valor -1 esto significa que es un registro nuevo por lo que se procede a registrar los datos del médico en la base de datos (línea 133), la función GrabarMedico devuelve el ID del registro insertado en la base de datos, en caso este valor devuelto es mayor a 0 quiere decir que el registro se realizó correctamente, luego se procederá con el registro de la lista de especialidades del médico recorriendo la lista de especialidades (línea 136), registrando la relación del médico - especialidad a través de la función GrabarEspecialidadDeMedico (línea 138), esta función recibe como parámetro los datos de especialidad, el ID del médico y el nombre del usuario que realiza la acción. Una vez registrado todo correctamente (línea 146), se procede a finalizar todas las operaciones (línea 149).
  Por otro lado, si el ID del objeto es diferente a -1 quiere decir que es un médico que ya se encuentra registrado en la base de datos, por lo que se realiza la acción de modificar (línea 164).
  La función EditarMedico devuelve true cuando la modificación se realizó correctamente. A continuación, se procede a registrar/modificar la lista de especialidades del médico, al igual que con el bloque de registrar médico aquí se valida el ID de la relación médico - especialidad (OJO el campo Id es el PK que identifica la relación del médico con la especialidad, mientras que el campo EspecialidadId contiene el ID de la especialidad), si el ID de la relación es 0, significa que es una relación que fue agregada recientemente al médico por lo que se debe registrar en la base de datos (línea 170), caso contrario se modificar los datos de la relación (línea 172).
  Finalmente una vez que se registró todo correctamente (línea 180) se procede a finalizar todas las operaciones (línea 183).

• medico: sirve para contener la información que se enviará y/o traerá del médico a registrar/editar.
• EliminarFilaSeleccionada: contiene la información de la especialidad que se desea eliminar al momento de pulsar sobre el icono eliminar que tiene cada fila de la tabla lista de especialidades del médico.
• indiceEspecialidad: sirve para identificar la última fila en la lista de especialidades ya que cada vez que se agrega una especialidad al médico se genera dinámicamente la caja de texto el cuál contiene una función de autocompletar.
• medicoIdEliminar: sirve para identificar a qué médico se desea eliminar al momento de pulsar sobre el icono eliminar que tendrá cada fila de la tabla donde se lista los médicos.
• listaEspecialidades: contiene la información de las especialidades que conoce el médico.
• listaEspecialidadesEliminadas: contiene la lista de especialidades que fueron eliminadas del médico, esta información se almacena en memoria porque la eliminación lógica (actualización de estados en la base de datos) se realiza cuando el usuario presiona el botón guardar.
• model: contiene las funciones que permiten interactuar al usuario con la vista.