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:
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.
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.
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.
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.