major restructure
This commit is contained in:
buenosairesam
@@ -0,0 +1,92 @@
|
||||
# Gestion de Solicitudes de Servicio
|
||||
|
||||
## Tipo de usuario
|
||||
Administrador / Operaciones
|
||||
|
||||
## Donde empieza
|
||||
Backoffice `/admin/` -> Dashboard o Seccion "Solicitudes"
|
||||
|
||||
## Que quiere hacer el usuario
|
||||
Ver, filtrar y gestionar todas las solicitudes de servicio del sistema
|
||||
|
||||
## Pasos - Ver solicitudes
|
||||
|
||||
1. Acceder al backoffice
|
||||
2. Ir a seccion "Solicitudes"
|
||||
3. Ver listado con todas las solicitudes
|
||||
4. Usar filtros para encontrar solicitudes especificas:
|
||||
- Por estado (Pendiente, Coordinado, Pagado, Completado, Cancelado)
|
||||
- Por fecha
|
||||
- Por barrio/zona
|
||||
- Por veterinario
|
||||
- Por dueno
|
||||
|
||||
## Pasos - Ver detalle de solicitud
|
||||
|
||||
1. Click en una solicitud del listado
|
||||
2. Ver toda la informacion:
|
||||
- Datos del dueno
|
||||
- Datos de la mascota
|
||||
- Servicios solicitados
|
||||
- Fechas preferidas
|
||||
- Veterinario asignado (si hay)
|
||||
- Estado de pago
|
||||
- Historial de cambios de estado
|
||||
|
||||
## Pasos - Asignar veterinario manualmente
|
||||
|
||||
1. Abrir solicitud en estado "Pendiente"
|
||||
2. Click en "Asignar veterinario"
|
||||
3. Ver lista de vets disponibles en la zona
|
||||
4. Seleccionar veterinario
|
||||
5. Seleccionar fecha y hora
|
||||
6. Confirmar asignacion
|
||||
7. Sistema notifica al vet y al dueno
|
||||
|
||||
## Pasos - Cambiar estado manualmente
|
||||
|
||||
1. Abrir solicitud
|
||||
2. Click en "Cambiar estado"
|
||||
3. Seleccionar nuevo estado
|
||||
4. Ingresar motivo (si aplica)
|
||||
5. Confirmar
|
||||
6. Se registra en el historial
|
||||
|
||||
## Que deberia pasar
|
||||
|
||||
- Vision completa de todas las solicitudes
|
||||
- Capacidad de intervenir cuando algo falla
|
||||
- Trazabilidad de cambios
|
||||
- Notificaciones a las partes afectadas
|
||||
|
||||
## Problemas comunes
|
||||
|
||||
- Solicitud sin vet disponible en la zona
|
||||
- Usuario pago pero webhook fallo
|
||||
- Vet no puede asistir y hay que reasignar
|
||||
- Dueno quiere cancelar pero ya pago
|
||||
- Solicitudes duplicadas del mismo dueno
|
||||
|
||||
## Casos especiales
|
||||
|
||||
- Solicitud urgente sin vets disponibles
|
||||
- Reasignacion a ultimo momento
|
||||
- Cancelacion con reembolso
|
||||
- Solicitud con datos incompletos
|
||||
- Dueno no responde a confirmaciones
|
||||
|
||||
## Flujos relacionados
|
||||
|
||||
- Proceso de reembolso
|
||||
- Gestion de usuarios
|
||||
- Reportes
|
||||
|
||||
## Notas tecnicas
|
||||
|
||||
- APIs:
|
||||
- `GET /solicitudes/api/v1/service-requests/` (listado con filtros)
|
||||
- `GET /solicitudes/api/v1/service-requests/{id}/` (detalle)
|
||||
- `PATCH /solicitudes/api/v1/service-requests/{id}/` (asignar vet)
|
||||
- `PATCH /solicitudes/api/v1/change-service-request-state/` (cambiar estado)
|
||||
- Estados validos: pending, coordinated, payed, completed, cancelled
|
||||
- Permisos: solo staff puede ver todas las solicitudes
|
||||
@@ -0,0 +1,106 @@
|
||||
# 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
|
||||
@@ -0,0 +1,98 @@
|
||||
# Gestion de Servicios y Precios
|
||||
|
||||
## Tipo de usuario
|
||||
Administrador
|
||||
|
||||
## Donde empieza
|
||||
Backoffice `/admin/` -> Seccion "Servicios" o Django Admin -> Productos
|
||||
|
||||
## Que quiere hacer el usuario
|
||||
Administrar el catalogo de servicios veterinarios y sus precios
|
||||
|
||||
## Pasos - Ver servicios
|
||||
|
||||
1. Ir a "Servicios"
|
||||
2. Ver listado de todos los servicios
|
||||
3. Filtrar por:
|
||||
- Categoria (Vacunacion, Consulta, Cirugia, etc.)
|
||||
- Tipo de mascota (Perro, Gato, Ambos)
|
||||
- Estado (Activo/Inactivo)
|
||||
|
||||
## Pasos - Agregar nuevo servicio
|
||||
|
||||
1. Click en "Agregar servicio"
|
||||
2. Completar datos:
|
||||
- Nombre del servicio
|
||||
- Descripcion
|
||||
- Categoria
|
||||
- Tipo de mascota aplicable
|
||||
- Precio base
|
||||
- Duracion estimada
|
||||
- Requiere otros servicios (dependencias)
|
||||
3. Guardar
|
||||
|
||||
## Pasos - Editar servicio
|
||||
|
||||
1. Abrir servicio existente
|
||||
2. Modificar campos
|
||||
3. Guardar
|
||||
4. Cambios aplican a nuevas solicitudes
|
||||
|
||||
## Pasos - Gestionar precios
|
||||
|
||||
1. Abrir servicio
|
||||
2. Ir a seccion "Precios"
|
||||
3. Ver precio actual
|
||||
4. Para cambiar precio:
|
||||
- Click "Agregar precio"
|
||||
- Ingresar monto
|
||||
- Definir fecha de vigencia
|
||||
- Guardar
|
||||
5. Precio anterior queda en historial
|
||||
|
||||
## Pasos - Configurar combos
|
||||
|
||||
1. Ir a "Combos" o "Paquetes"
|
||||
2. Crear nuevo combo:
|
||||
- Nombre del combo
|
||||
- Servicios incluidos
|
||||
- Precio del combo (con descuento)
|
||||
- Condiciones de aplicacion
|
||||
3. Guardar
|
||||
|
||||
## Que deberia pasar
|
||||
|
||||
- Catalogo actualizado de servicios
|
||||
- Precios correctos en el turnero
|
||||
- Combos aplicados automaticamente
|
||||
- Historial de precios para facturacion
|
||||
|
||||
## Problemas comunes
|
||||
|
||||
- Cambio de precio afecta solicitudes ya creadas
|
||||
- Servicio deprecado pero con solicitudes pendientes
|
||||
- Combo no se aplica automaticamente
|
||||
- Precio diferente por zona/vet
|
||||
|
||||
## Casos especiales
|
||||
|
||||
- Servicio con precio variable (depende de peso mascota)
|
||||
- Servicio estacional (solo ciertas epocas)
|
||||
- Promocion temporal
|
||||
- Precio especial por vet
|
||||
|
||||
## Flujos relacionados
|
||||
|
||||
- Turnero (muestra servicios disponibles)
|
||||
- Facturacion (usa precios)
|
||||
|
||||
## Notas tecnicas
|
||||
|
||||
- APIs:
|
||||
- `GET /productos/api/v1/services/` (servicios)
|
||||
- `POST /productos/api/v1/services/` (crear)
|
||||
- `PATCH /productos/api/v1/services/{id}/` (editar)
|
||||
- `GET /productos/api/v1/prices/` (precios)
|
||||
- `POST /productos/api/v1/prices/` (nuevo precio)
|
||||
- Modelo Price tiene fecha de vigencia
|
||||
- Precio se congela al momento de crear solicitud
|
||||
@@ -0,0 +1,82 @@
|
||||
# Proceso de Reembolso
|
||||
|
||||
## Tipo de usuario
|
||||
Administrador / Operaciones
|
||||
|
||||
## Donde empieza
|
||||
Backoffice -> Solicitud pagada -> "Procesar reembolso" o Seccion "Pagos"
|
||||
|
||||
## Que quiere hacer el usuario
|
||||
Procesar un reembolso para un turno que fue cancelado despues del pago
|
||||
|
||||
## Pasos - Identificar solicitud a reembolsar
|
||||
|
||||
1. Buscar la solicitud por:
|
||||
- ID de solicitud
|
||||
- Nombre del dueno
|
||||
- Numero de operacion de Mercado Pago
|
||||
2. Verificar que esta en estado "Pagado"
|
||||
3. Verificar que el pago fue exitoso
|
||||
|
||||
## Pasos - Procesar reembolso
|
||||
|
||||
1. Abrir detalle de la solicitud
|
||||
2. Click en "Procesar reembolso"
|
||||
3. Ver informacion del pago:
|
||||
- Monto pagado
|
||||
- Fecha de pago
|
||||
- Metodo de pago
|
||||
- ID de operacion MP
|
||||
4. Seleccionar tipo de reembolso:
|
||||
- Total
|
||||
- Parcial (ingresar monto)
|
||||
5. Ingresar motivo del reembolso
|
||||
6. Confirmar
|
||||
7. Sistema procesa reembolso en Mercado Pago
|
||||
8. Actualizar estado de la solicitud
|
||||
|
||||
## Pasos - Verificar reembolso
|
||||
|
||||
1. Ir a seccion "Pagos" o historial de la solicitud
|
||||
2. Verificar que el reembolso fue procesado
|
||||
3. Ver estado del reembolso en Mercado Pago
|
||||
|
||||
## Que deberia pasar
|
||||
|
||||
- Reembolso procesado en Mercado Pago
|
||||
- Dueno recibe el dinero (segun tiempos de MP)
|
||||
- Solicitud actualiza estado
|
||||
- Registro en el historial
|
||||
- Dueno notificado por email
|
||||
|
||||
## Problemas comunes
|
||||
|
||||
- Reembolso parcial no soportado por el metodo de pago
|
||||
- Plazo de reembolso vencido (politica de MP)
|
||||
- Dueno reclama que no recibio el dinero
|
||||
- Reembolso duplicado por error
|
||||
- Pago original en disputa
|
||||
|
||||
## Casos especiales
|
||||
|
||||
- Reembolso por mala atencion
|
||||
- Reembolso parcial (solo algunos servicios)
|
||||
- Visita incompleta (reembolso proporcional)
|
||||
- Dueno quiere credito en vez de reembolso
|
||||
- Reembolso fuera de plazo (solucion alternativa)
|
||||
|
||||
## Flujos relacionados
|
||||
|
||||
- Gestion de solicitudes
|
||||
- Cancelacion de turno
|
||||
- Atencion al cliente
|
||||
|
||||
## Notas tecnicas
|
||||
|
||||
- API Mercado Pago: `POST /v1/payments/{id}/refunds`
|
||||
- Tiempos de acreditacion:
|
||||
- Tarjeta credito: 1-2 estados de cuenta
|
||||
- Tarjeta debito: 5-10 dias habiles
|
||||
- Dinero en cuenta MP: inmediato
|
||||
- Plazo maximo para reembolso: 180 dias desde el pago
|
||||
- Se debe guardar log de todos los reembolsos
|
||||
@@ -0,0 +1,99 @@
|
||||
# Reportes y Dashboard
|
||||
|
||||
## Tipo de usuario
|
||||
Administrador / Gerencia
|
||||
|
||||
## Donde empieza
|
||||
Backoffice `/admin/` -> Dashboard o Seccion "Reportes"
|
||||
|
||||
## Que quiere hacer el usuario
|
||||
Ver metricas del negocio, generar reportes y analizar datos
|
||||
|
||||
## Pasos - Ver dashboard
|
||||
|
||||
1. Acceder al backoffice
|
||||
2. Ver dashboard principal con:
|
||||
- Solicitudes del dia/semana/mes
|
||||
- Ingresos del periodo
|
||||
- Visitas completadas
|
||||
- Conversion (solicitudes -> pagos)
|
||||
- Vets activos
|
||||
|
||||
## Pasos - Generar reporte de solicitudes
|
||||
|
||||
1. Ir a "Reportes" -> "Solicitudes"
|
||||
2. Seleccionar rango de fechas
|
||||
3. Filtrar por:
|
||||
- Estado
|
||||
- Zona
|
||||
- Veterinario
|
||||
- Tipo de servicio
|
||||
4. Click "Generar"
|
||||
5. Ver tabla con resultados
|
||||
6. Opcion de exportar (CSV/Excel)
|
||||
|
||||
## Pasos - Generar reporte de ingresos
|
||||
|
||||
1. Ir a "Reportes" -> "Ingresos"
|
||||
2. Seleccionar periodo
|
||||
3. Agrupar por:
|
||||
- Dia/Semana/Mes
|
||||
- Veterinario
|
||||
- Servicio
|
||||
- Zona
|
||||
4. Ver grafico y tabla
|
||||
5. Exportar si es necesario
|
||||
|
||||
## Pasos - Reporte de veterinarios
|
||||
|
||||
1. Ir a "Reportes" -> "Veterinarios"
|
||||
2. Ver para cada vet:
|
||||
- Visitas completadas
|
||||
- Calificacion promedio
|
||||
- Ingresos generados
|
||||
- Tasa de cancelacion
|
||||
3. Filtrar por periodo
|
||||
4. Ordenar por metrica
|
||||
|
||||
## Pasos - Exportar datos
|
||||
|
||||
1. En cualquier reporte, click "Exportar"
|
||||
2. Seleccionar formato (CSV, Excel)
|
||||
3. Descargar archivo
|
||||
4. Usar para analisis externo o contabilidad
|
||||
|
||||
## Que deberia pasar
|
||||
|
||||
- Vision clara del estado del negocio
|
||||
- Datos para toma de decisiones
|
||||
- Reportes exportables para contabilidad
|
||||
- Identificacion de tendencias
|
||||
|
||||
## Problemas comunes
|
||||
|
||||
- Datos no actualizados en tiempo real
|
||||
- Filtros que no devuelven lo esperado
|
||||
- Discrepancia entre reportes y realidad
|
||||
- Exportacion con formato incorrecto
|
||||
|
||||
## Casos especiales
|
||||
|
||||
- Reporte de prueba vs produccion
|
||||
- Datos historicos antes de implementar filtro
|
||||
- Comparativa año vs año
|
||||
- Reporte personalizado para inversores
|
||||
|
||||
## Flujos relacionados
|
||||
|
||||
- Gestion de solicitudes (fuente de datos)
|
||||
- Facturacion AFIP
|
||||
- Google Sheets sync
|
||||
|
||||
## Notas tecnicas
|
||||
|
||||
- API:
|
||||
- `GET /mascotas/api/v1/stats-summary` (metricas principales)
|
||||
- `GET /solicitudes/api/v1/service-requests/?date_from=X&date_to=Y` (datos crudos)
|
||||
- Google Sheets: sincronizacion automatica via Celery
|
||||
- Dashboard actualiza cada 5 minutos
|
||||
- Reportes pesados: generar async y notificar cuando estan listos
|
||||
Reference in New Issue
Block a user