soleprint/atlas/book/feature-form-samples/feature-form/backoffice/02-gestion-usuarios.md

Gestion de Usuarios

Tipo de usuario

Administrador / Operaciones

Donde empieza

Backoffice /admin/ -> Seccion "Usuarios" o "Duenos" / "Veterinarios"

Que quiere hacer el usuario

Administrar duenos de mascotas y veterinarios del sistema

Pasos - Ver/Buscar duenos

1. Ir a "Duenos de mascotas"
2. Ver listado de todos los duenos
3. Usar buscador (nombre, email, telefono)
4. Filtrar por:
   • Tipo (Registrado / Invitado)
   • Fecha de registro
   • Con/sin turnos activos

Pasos - Ver detalle de dueno

1. Click en un dueno
2. Ver informacion completa:
   • Datos personales
   • Direcciones registradas
   • Mascotas
   • Historial de solicitudes
   • Historial de pagos

Pasos - Editar dueno

1. En el detalle, click "Editar"
2. Modificar campos permitidos:
   • Nombre
   • Telefono
   • Email
   • Direccion
3. Guardar cambios

Pasos - Gestionar veterinarios

1. Ir a "Veterinarios"
2. Ver listado con:
   • Nombre y matricula
   • Zonas de cobertura
   • Estado (Activo/Inactivo)
   • Turnos del mes

Pasos - Agregar nuevo veterinario

1. Click en "Agregar veterinario"
2. Completar datos:
   • Nombre completo
   • Numero de matricula
   • Email
   • Telefono
   • Especialidades
   • Zonas de cobertura inicial
3. Crear credenciales de acceso
4. Guardar

Pasos - Desactivar veterinario

1. Abrir perfil del vet
2. Click en "Desactivar"
3. Confirmar
4. Vet deja de recibir solicitudes
5. Visitas ya aceptadas se mantienen o se reasignan

Que deberia pasar

• Gestion completa de usuarios del sistema
• Capacidad de corregir datos erroneos
• Alta/baja de veterinarios
• Vision del estado de cada usuario

Problemas comunes

• Duenos duplicados (se registraron con email diferente)
• Vet quiere darse de baja pero tiene citas pendientes
• Email incorrecto y no reciben notificaciones
• Cuenta de invitado que quiere convertirse en registrada

Casos especiales

• Fusionar cuentas duplicadas
• Transferir mascota a otro dueno
• Vet de vacaciones temporalmente
• Cambio de numero de matricula

Flujos relacionados

• Gestion de solicitudes (ver historial por usuario)
• Reportes (filtrar por usuario)

Notas tecnicas

• APIs:
  • GET /mascotas/api/v1/pet-owners/ (duenos)
  • GET /mascotas/api/v1/veterinarians/ (vets)
  • POST /mascotas/api/v1/veterinarians/ (crear vet)
  • PATCH /mascotas/api/v1/veterinarians/{id}/ (editar/desactivar)
• Permisos: solo staff puede modificar usuarios
• Soft delete para mantener historial