DOCUMENTACIÓN

Manual de Uso

Guía de acceso y funcionamiento de la aplicación para los perfiles Cliente, Empleado y Administrador.

1 Registro y Login

1.1 Login

Los usuarios registrados acceden desde el enlace Login en el menú principal de navegación mediante su nombre de usuario (email de registro) y contraseña.

1.2 Registro de nuevo usuario

Pueden registrarse en el enlace Registrarse en el menú de navegación, respetando las siguientes restricciones:

Restricciones
Todos los campos son obligatorios.
Email: debe ser un email válido y no debe existir para otro cliente.
DNI: debe ser un DNI, NIF o NIE válido y no debe existir para otro cliente.
Contraseña: longitud mínima de 8 caracteres; debe incluir al menos una mayúscula, una minúscula y un número.

2 Dashboard de Cliente

2.1 General

Los usuarios registrados como clientes acceden al panel de control con las acciones correspondientes a su rol. La vista incluye los datos del perfil, así como los enlaces para editar dichos datos o solicitar la eliminación de su cuenta. También da acceso a la gestión de sus reportajes, citas y pedidos.

2.2 Edición de datos del perfil

Mediante el botón Editar mi perfil, los usuarios pueden acceder a un formulario para modificar los datos de su cuenta, manteniendo las mismas condiciones de seguridad que las requeridas en el registro.

2.3 Eliminación de la cuenta

Marcando el checkbox Solicito eliminar mi perfil, la cuenta del cliente se marcará para su eliminación, que será llevada a cabo por un administrador. Hasta su eliminación definitiva, el cliente podrá acceder a su cuenta y cancelar la solicitud desmarcando el checkbox.

2.4 Gestión de reportajes

Desde la pestaña Ver mis reportajes, el cliente puede acceder a un listado de sus reportajes. Pulsando el botón Ver fotos se accede a la galería paginada de fotografías. Desde la vista paginada puede accederse a la vista completa de la fotografía pulsando sobre la miniatura.

Cada foto incluye el botón Añadir al carrito.

2.5 Gestión de cita

Un cliente registrado puede solicitar una cita pulsando el enlace Cita del menú principal. Desde esta sección, el cliente accede a la vista del calendario, donde pulsando sobre un día puede reservar o cambiar su cita. Mediante el boton inferior Cancelar mi cita, el cliente puede cancelar su cita concertada.

Restricciones
Solo una cita por cliente.
No es posible reservar turnos ya ocupados ni reservar días pasados.

La pestaña Ver mi cita muestra los datos de la cita si existe.

2.6 Realización y gestión de pedidos

Los usuarios registrados pueden realizar pedidos de copias físicas o licencia digital tanto de fotografías privadas como públicas. Las fotografías públicas se acceden desde el botón Galería.

Al añadir una foto al carrito aparece una ventana emergente para seleccionar formato y soporte. El carrito admite hasta 15 ítems.


Vista del carrito

La vista del carrito muestra:

  • Nombre de la foto
  • Reportaje
  • Formato y soporte
  • Precio y cantidad
  • Y las Acciones: Eliminar, Vaciar carrito, Enviar pedido

La pestaña Ver mis pedidos muestra el historial y permite cancelar pedidos en estado Emitido o Presupuestado.

3 Dashboard de Empleado

3.1 General

Los usuarios registrados como empleados acceden al panel de control con las acciones correspondientes a su rol. La vista incluye los datos de perfil y los enlaces para editar dichos datos de forma idéntica al perfil Cliente. También da acceso a las opciones de administración básica ligadas a su rol.

3.2 Gestión de reportajes

La pestaña desplegable Gestión de Reportajes muestra las opciones de administración de estos.

Importante
Cada reportaje va ligado a una carpeta en el almacenamiento principal de la aplicación:
(root)\storage\app\private\fotosreportajes\<CÓDIGO>
. El nombre de la carpeta debe coincidir exactamente con el CÓDIGO del reportaje. Esto es fundamental para el correcto funcionamiento de la aplicación.

3.2.1 Registrar nuevo reportaje

Mediante el botón Nuevo Reportaje se muestran las opciones para registrar un reportaje en la base de datos. Al pulsar Crear Reportaje, el sistema comprueba el estado de la carpeta asociada y da las opciones:

  • Si la Carpeta EXISTE y está VACÍA: se registra el reportaje vacío en la base de datos.
  • Si la Carpeta NO EXISTE: el sistema pregunta si desea crearla o registrar solo el reportaje.
  • Si la Carpeta EXISTE con fotografías: el sistema lista las fotos encontradas y ofrece añadirlas todas o crear el reportaje sin fotos.

3.2.2 Ver listado de reportajes

Desde el botón Ver todos los reportajes se accede a una lista completa. El formulario de búsqueda permite filtrar por ID, email, tipo, código, descripción, fecha y visibilidad.


3.2.3 Eliminar reportajes

Al eliminar un reportaje, el sistema comprueba si existe carpeta asociada al código:

  • Si la Carpeta NO EXISTE: se elimina el reportaje de la BD directamente.
  • Si la Carpeta EXISTE: el sistema pregunta si desea eliminar también la carpeta y las fotos del servidor, o si solo eliminar el registro en la base de datos.

3.2.4 Editar reportaje

Desde el botón Modificar se accede al formulario de edición. Si se cambia el código del reportaje, el sistema vuelve a comprobar la carpeta:

  • Si la Carpeta NO EXISTE: se cambia el código en la base de datos.
  • Si la Carpeta EXISTE: el sistema ofrece renombrar la carpeta y la entrada en BD, o renombrar solo la entrada sin renombrar la carpeta.

3.3 Gestión de fotografías

La pestaña Gestión de Fotografías permite administrar las fotos de los reportajes.

Importante
Cada fotografía va ligada a un archivo físico dentro de la carpeta del reportaje, cuyo nombre coincide con el nombre de la fotografía en la base de datos, incluido su extensión. Además, existe una carpeta thumbs con las miniaturas, con el mismo nombre que el archivo de foto principal.

3.3.1 Registrar nueva fotografía

Desde el botón Registrar nueva fotografía se accede al formulario de registro. El formulario solicita el nombre del archivo (con extensión) y el código del reportaje al que pertenece. Y comprueba si existe el archivo en el servidor.

  • Si el archivo EXISTE: en el servidor, se registra directamente
  • Si el archivo NO EXISTE:, el sistema pregunta si desea agregarlo de todas formas.

3.3.2 Ver listado de fotografías

Desde Ver todas las fotografías o mediante el buscador se accede a una galería paginada con miniaturas, desde donde puede visualizar cada fotografía en detalle o ejecutar otras acciones disponibles, borrar, renombrar y añadir al carrito.

3.4 Gestión de pedidos

Los empleados pueden acceder a la gestión de pedidos desde su panel de control. Pueden acceder a un listado completo de pedidos realizados por los clientes, con la posibilidad de filtrar por parámetros específicos.

Desde el listado se puede acceder al detalle de cada pedido, así como a la opciones de edición de los mismos o eliminacion desde los botones Detalles, Modificar y Borrar.

Para añadir items a un pedido, serealiza añadiendo los items al carrito y pulsando Editar pedido y añadir Items desde la vista de edición del mismo.

Para crear un pedido nuevo para un cliente, el empleado debe reliazar primero el pedido a su nombre y posteriormente adjudicarlo el usuario final desde la vista de edición del pedido.

3.5 Gestión de citas

Desde la pestaña desplegable Gestión de citas, los empleados pueden acceder al listado de todas las citas registradas en el sistema o filtrado por parámetros específicos.

Desde el listado correspondiente, pueden Eliminarse o modificar las citas registradas en el sistema (cambiar fecha, usuario, estado, etc.).

Para crear una nueva cita para un cliente, el empleado debe realizar primero la reserva a su nombre y posteriormente adjudicarla al usuario final desde la vista de edición de la cita.

3.6 Gestión de etiquetas

Las etiquetas se utilizan para clasificar fotografías públicas en la galería. Desde la pestaña Gestión de etiquetas, los empleados pueden acceder al listado de etiquetas existentes. El empleado puede crear y eliminar etiquetas. Los nombres de las etiquetas deben ser únicos y son case-insensitive.

4 Dashboard de Administrador

4.1 General

Los administradores tienen acceso a todas las funciones del sistema, su panel de control incluye las funciones de los empleados, así como las funciones de administración avanzada, incluyendo la gestión completa de usuarios, formatos, soportes y mantenimiento de la base de datos.

4.2 Gestión de usuarios

Desde la pestaña Gestión de usuarios, el administrador puede acceder al listado de todos los usuarios registrados en el sistema, con la posibilidad de filtrar por parámetros específicos. Además de la posibilidad de crear nuevos usuarios.

Desde el listado de usuarios, el administrador puede acceder a la edición o eliminación de los mismos, con las posibilidades de:

  • Editar los datos del perfil
  • Cambiar contraseña
  • Restaurar cuentas marcadas para eliminación
  • Cambiar roles y privilegios

4.3 Gestión de formatos

Los formatos representan los tamaños de impresión disponibles (por ejemplo: 10x15, 13x18, 50x70). Desde la pestaña Gestión de formatos, el administrador puede crear y acceder a los listados totales o filtrados de formatos, y desde estos listados editar y eliminar formatos.

4.4 Gestión de soportes

Los soportes representan el material sobre el que se imprime la fotografía. Desde la pestaña Gestión de soportes, el administrador puede acceder a la creación y listado de soportes, y desde estos listados a la edición, política de precios y eliminación de los mismos.

4.5 Mantenimiento de base de datos

En la pestaña Mantenimiento de base de datos, el administrador dispone de herramientas para limpiar registros fantasma:

  • Buscar clientes fantasma: Busca clientes que no han realizado pedidos, no tienen reportajes registrados ni cita agendada
  • Buscar reportajes fantasma: Localiza reportajes en la base de datos cuyo directorio de fotos asociado no existe en el almacenamiento
  • Buscar fotos fantasma: Identifica fotos en la base de datos que no tienen un archivo asociado en el almacenamiento
  • Buscar pedidos fantasma: Localiza pedidos vacíos (sin items) en la base de datos.