Conceptos básicos

Antes de comenzar a usar ResidencialAdmin, es útil entender algunos conceptos clave del sistema.

Roles de usuario

En ResidencialAdmin, cada usuario tiene uno o más roles que determinan qué puede hacer dentro del sistema:

Rol	Descripción	Aplicación
Residente	Dueño o habitante de una propiedad	App móvil
Guardia	Personal de seguridad en caseta	App móvil
Administrador de coto	Gestiona un fraccionamiento específico	Panel web
Super Admin	Gestiona múltiples fraccionamientos	Panel web

Roles múltiples

Un usuario puede tener varios roles. Por ejemplo, un residente también puede ser guardia si trabaja en seguridad.

Códigos QR

Los códigos QR son el corazón del sistema de accesos. Funcionan así:

Residente genera código → Visitante recibe código → Guardia escanea código → Acceso registrado

Tipos de código

• Visita única: Un solo uso, expira después de ser escaneado
• Visita múltiple: Permite múltiples entradas durante un período
• Frecuente: Para personas que visitan regularmente (ej: empleada doméstica)
• Proveedor: Para servicios recurrentes (ej: jardinero, gas)

Propiedades y unidades

Una propiedad representa una vivienda dentro del fraccionamiento:

• Casa
• Departamento
• Local comercial (si aplica)

Cada propiedad tiene:

• Dirección única (ej: "Calle Pinos #123")
• Uno o más residentes asignados
• Historial de accesos
• Estado de cuenta

Amenidades

Las amenidades son áreas comunes que pueden reservarse:

• 🏊 Alberca
• 🏋️ Gimnasio
• 🎉 Salón de fiestas
• 🎾 Cancha de tenis
• 🌳 Áreas verdes
• 👶 Área de juegos

Cada amenidad tiene:

• Horario de disponibilidad
• Capacidad máxima
• Costo de reservación (si aplica)
• Reglas de uso

Incidencias

Una incidencia es un reporte de algo que requiere atención:

• 🔧 Mantenimiento (fuga de agua, luz fundida)
• 🚨 Seguridad (actividad sospechosa, alarma)
• 🚗 Estacionamiento (vehículo mal estacionado)
• 📢 Ruido (fiesta, obras)
• 🐕 Mascotas (mascota suelta)

Las incidencias pasan por estados:

1. Reportada → Enviada a administración
2. En proceso → Se está atendiendo
3. Resuelta → Problema solucionado
4. Cerrada → Confirmado por el residente

Cuotas y pagos

El sistema maneja los siguientes conceptos financieros:

• Cuota ordinaria: Pago mensual/trimestral de mantenimiento
• Cuota extraordinaria: Pagos especiales para proyectos específicos
• Multas: Penalizaciones por infracciones al reglamento
• Reservaciones: Costo por uso de amenidades

Comunicados

Los comunicados son mensajes de la administración a los residentes:

• Avisos generales: Información para todos
• Urgentes: Requieren atención inmediata
• Por área: Solo para ciertos sectores
• Personales: Dirigidos a una propiedad específica

Glosario rápido

Término	Significado
Coto/Fraccionamiento	Conjunto residencial privado
Caseta	Punto de control de acceso
Bitácora	Registro de eventos y accesos
Multi-tenant	Sistema que sirve a múltiples fraccionamientos