# Manual de Usuario - Turnilup (Citalis)

## Sistema de Gestión de Citas y Reservas

---

## 1. Introducción

Turnilup es una plataforma de gestión de citas diseñada para profesionales y negocios que necesitan administrar sus reservas de manera eficiente. Permite gestionar recursos (profesionales), tipos de citas, disponibilidad y reservas de clientes.

---

## 2. Acceso a la Plataforma

### 2.1 Landing Page (Página Pública)

La URL base de la plataforma muestra la landing page de Citalis con información sobre el servicio.

**URL:** `https://citalis.app/`

Desde aquí puedes:
- Conocer los beneficios del sistema
- Ver los planes disponibles
- Registarte como nuevo usuario

### 2.2 Registro de Usuario

**URL:** `https://citalis.app/register`

Pasos para registrarse:
1. Ingresa tu correo electrónico
2. Crea una contraseña segura
3. Verifica tu cuenta mediante código enviado a tu email

### 2.3 Inicio de Sesión

**URL:** `https://citalis.app/login`

Ingresa tu correo y contraseña para acceder al panel de gestión.

---

## 3. Panel de Control (Dashboard)

### 3.1 Acceso

**URL:** `https://citalis.app/dashboard`

El dashboard es el centro de gestión donde encontrarás:
- Resumen de citas próximas
- Estadísticas rápidas
- Accesos a todas las funcionalidades

### 3.2 Configuración del Negocio

**URL:** `https://citalis.app/business/settings`

Para que el sistema funcione, primero debes configurar tu negocio:

1. **Información básica**
   - Nombre del negocio
   - Slug (URL amigable, ej: mi-negocio)

2. **Datos de contacto**
   - Teléfono principal
   - Teléfono secundario
   - Email de contacto
   - Sitio web (opcional)

3. **Ubicación**
   - Dirección
   - Ciudad
   - País

4. **Configuración**
   - Logo (imagen)
   - Zona horaria
   - Mensaje de banner (opcional)

5. **Estado del negocio**
   - Disponible / Alta Demanda / Cerrado Temporalmente

---

## 4. Gestión de Recursos

Los recursos representan a los profesionales, empleados o personas que atienden las citas.

### 4.1 Lista de Recursos

**URL:** `https://citalis.app/scheduler/resources/`

### 4.2 Crear Recurso

1. Accede a la lista de recursos
2. Haz clic en "Agregar Recurso"
3. Completa los campos:
   - **Nombre:** Nombre del profesional
   - **Email:** Correo electrónico (opcional)
   - **Foto:** Imagen del profesional (opcional)
4. Activa el recurso
5. Guarda

**Funcionalidades:**
- Editar recurso
- Desactivar (eliminado lógico)
- Ver servicios asignados

---

## 5. Gestión de Servicios (Tipos de Citas)

Los tipos de citas definen los servicios que ofrece tu negocio.

### 5.1 Lista de Servicios

**URL:** `https://citalis.app/scheduler/services/`

### 5.2 Crear Tipo de Cita

1. Accede a la lista de servicios
2. Haz clic en "Agregar Servicio"
3. Completa los campos:

   | Campo | Descripción |
   |-------|-------------|
   | Nombre | Nombre del servicio (ej: "Consulta Médica") |
   | Slug | Identificador URL (ej: consulta-medica) |
   | Descripción | Detalles del servicio |
   | Duración | Tiempo en minutos (30, 45, 60, etc.) |
   | Capacidad | Citas simultáneas por slot |
   | Recursos | Profesionales que ofrecen este servicio |

4. Activa el servicio
5. Guarda

### 5.3 Campos Personalizados

Puedes agregar campos adicionales para collects datos específicos de los clientes:

**URL:** `https://citalis.app/scheduler/services/[id]/fields/`

Tipos disponibles:
- **Texto:** Campo de texto libre
- **Selección:** Lista desplegable con opciones
- **Checkbox:** Casilla de verificación

---

## 6. Configuración de Disponibilidad

### 6.1 Horarios Semanales

**URL:** `https://citalis.app/scheduler/availability/`

Define los horarios de atención para cada día de la semana:

1. Selecciona el día (Lunes-Domingo)
2. Configura el horario de inicio y fin
3. Opcionalmente define un rango de descanso (almuerzo)
4. Asigna a un recurso específico o general
5. Guarda

**Ejemplo:**
- Lunes: 09:00 - 13:00 y 14:00 - 18:00
- Descanso: 13:00 - 14:00

### 6.2 Días Bloqueados

**URL:** `https://citalis.app/scheduler/blocked-days/`

Bloquea períodos completos donde no hay atención:

1. Fecha de inicio
2. Fecha de fin
3. Motivo (opcional)
4. Recurso específico (opcional)

### 6.3 Días de Excepción

**URL:** `https://citalis.app/scheduler/exceptions/`

Modifica la disponibilidad de días específicos:

- **Día disponible:** Hacer disponible un día normalmente cerrado
- **Día no disponible:** Cerrar un día normalmente abierto
- **Horario especial:** Establecer horarios diferentes al habitual

### 6.4 Feriados

**URL:** `https://citalis.app/scheduler/holidays/`

Registra los feriados nacionales o locales:

1. Fecha del feriados
2. Nombre/descripción
3. El sistema bloqueará automáticamente estas fechas

---

## 7. Página de Reservas Pública

### 7.1 Acceso del Cliente

Los clientes acceden a través de una URL personalizada:

**URL:** `https://citalis.app/[slug-negocio]/[slug-servicio]/`

Ejemplo: `https://citalis.app/clinica-dental/limpieza-dental/`

### 7.2 Proceso de Reserva

El cliente sigue estos pasos:

1. **Selección de Fecha**
   - Visualiza el calendario
   - Selecciona un día disponible

2. **Selección de Horario**
   - Ve los horarios disponibles para esa fecha
   - Elige un slot

3. **Datos del Cliente**
   - Nombre completo
   - Correo electrónico
   - Teléfono
   - Tipo de documento (RUT, Pasaporte, etc.)
   - Número de documento
   - Campos personalizados del servicio

4. **Confirmación**
   - Revisa los datos
   - Confirma la reserva
   - Recibe email de confirmación

### 7.3 Gestión de la Cita (Cliente)

El cliente recibe un enlace para gestionar su reserva:

- **Editar:** Modificar datos de la reserva
- **Cancelar:** Cancelar la cita

---

## 8. Gestión de Citas (Profesional)

### 8.1 Lista de Citas

**URL:** `https://citalis.app/appointments/`

Ver todas las reservas con filtros por:
- Estado (Confirmada, Pendiente, Cancelada, etc.)
- Fecha
- Servicio

### 8.2 Estados de Citas

| Estado | Descripción |
|--------|-------------|
| Confirmada | Cita agendada normalmente |
| Pendiente | Esperando confirmación |
| Cancelada | Cita cancelada por cliente/profesional |
| Reprogramada | Cita reagendada |
| No asistió | Cliente no llegó |

### 8.3 Acciones sobre Citas

- **Ver detalles:** Información completa de la reserva
- **Editar:** Modificar fecha, hora o datos del cliente
- **Cambiar estado:** Actualizar estado de la cita
- **Cancelar:** Anular la reserva
- **Agregar notas:** Comentarios internos

---

## 9. Planes y Suscripciones

### 9.1 Planes Disponibles

**URL:** `https://citalis.app/payments/plans/`

Consulta los planes disponibles y sus características.

### 9.2 Historial de Pagos

**URL:** `https://citalis.app/payments/history/`

Visualiza tu historial de suscripciones y pagos.

---

## 10. URLs de Referencia Rápida

| Funcionalidad | URL |
|---------------|-----|
| Landing Page | `/` |
| Login | `/login/` |
| Registro | `/register/` |
| Dashboard | `/dashboard/` |
| Configuración del negocio | `/business/settings/` |
| Recursos | `/scheduler/resources/` |
| Servicios | `/scheduler/services/` |
| Disponibilidad semanal | `/scheduler/availability/` |
| Días bloqueados | `/scheduler/blocked-days/` |
| Excepciones | `/scheduler/exceptions/` |
| Feriados | `/scheduler/holidays/` |
| Lista de citas | `/appointments/` |
| Planes | `/payments/plans/` |
| Historial de pagos | `/payments/history/` |

---

## 11. Flujo de Uso Recomendado

### Para empezar a usar el sistema:

1. **Registro:** Crea tu cuenta
2. **Configuración del negocio:** Completa los datos de tu empresa
3. **Crea recursos:** Agrega tus profesionales/empleados
4. **Crea servicios:** Define los tipos de citas que ofreces
5. **Configura disponibilidad:** Establece tus horarios de atención
6. **Comparte tu link:** Envía la URL de reservas a tus clientes

---

## 12. Soporte

Si tienes dudas o necesitas ayuda, contacta al equipo de soporte a través de los canales disponibles en la plataforma.