Conceptos básicos

Antes de comenzar a usar ResidencialAdmin, es útil entender algunos conceptos clave del sistema. Los términos de esta página coinciden con los que verás en la app y el panel web.

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
Admin de coto	Gestiona un fraccionamiento específico	Panel web
Owner / Soporte	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. Desde Perfil podrás "Cambiar rol" si tienes más de uno asignado.

Permisos de acceso

Un Permiso es la autorización que generas para que alguien entre al fraccionamiento. En la app aparece como "Permiso", "Mis Permisos" y "Crear Permiso".

Residente crea permiso → Comparte el QR con el visitante → Guardia escanea → Acceso registrado

Tipos de permiso

Tipo	Cuándo usarlo
Único	Una sola visita (entrega, técnico, invitado ocasional)
Temporal	Vigencia por un periodo (familia de visita varios días, contratistas)
Frecuente	Personas que entran de forma recurrente (empleada doméstica, niñera)
Proveedor	Servicios recurrentes (gas, agua, jardinería)

Estados de un permiso

Estado	Significado
Activo	Vigente y disponible para usar
Usado	Ya se utilizó (aplica a tipo Único o cuando se alcanzó el máximo de entradas)
Expirado	Pasó su fecha de vigencia
Cancelado	Lo cancelaste manualmente

Accesos

Un Acceso es el registro de cada entrada o salida en caseta. Cada acceso queda guardado con:

• Nombre del visitante
• Tipo: entrada o salida
• Método: QR (escaneado) o manual (capturado por el guardia)
• Fecha y hora
• Permiso asociado (si lo hubo)

Propiedades (Casas)

Una Casa representa una vivienda dentro del fraccionamiento:

• Casa
• Departamento
• Local comercial (si aplica)

Cada casa tiene:

• Número y dirección
• Uno o más residentes asignados
• Historial de accesos
• Estado de cuenta (cuotas)

Amenidades y Reservaciones

Las Amenidades son áreas comunes que pueden reservarse:

• Alberca, Gimnasio, Salón de fiestas, Canchas, Palapa/Terraza, Área de juegos, etc.

Cada amenidad tiene capacidad máxima, costo (si aplica) y si requiere aprobación del administrador.

Estados de una reservación

Estado	Significado
Pendiente	Solicitud enviada, esperando aprobación de administración
Aprobada	Confirmada y lista para usar
Rechazada	No fue aprobada
Cancelada	La cancelaste tú o la administración
Completada	El periodo de uso terminó

Cuotas y pagos

El sistema maneja los siguientes conceptos financieros:

• Cuota ordinaria: Pago periódico de mantenimiento
• Cuota extraordinaria: Pagos especiales para proyectos específicos
• Multas: Penalizaciones por infracciones al reglamento

Estados de una cuota

Estado	Significado
Pendiente	Por pagar, dentro del periodo de vigencia
Pagada	Liquidada
Vencida	Pasó la fecha límite sin pagarse

Incidencias

Una Incidencia es un reporte de algo que requiere atención. La app permite reportarla con categoría y prioridad.

Categorías disponibles

• Mantenimiento — Reparaciones, fallas técnicas, infraestructura
• Seguridad — Situaciones de riesgo, accesos no autorizados
• Convivencia — Conflictos vecinales, ruido, mascotas
• Otro — Cualquier otra situación

Prioridades

Baja (verde) · Media (amarillo) · Alta (naranja) · Urgente (rojo)

Estados de una incidencia

Estado	Significado
Abierta	Reporte recibido
En progreso	Se está atendiendo
Resuelta	El problema fue solucionado
Cerrada	Caso cerrado

Anuncios

Los Anuncios son comunicados de la administración a los residentes. En la app móvil aparecen en la pantalla "Anuncios" y se clasifican por tipo:

• General — Información para todos
• Urgente — Alertas importantes
• Evento — Convocatorias y eventos del coto
• Mantenimiento — Avisos de obras, cortes de agua/luz

Paquetes

Cuando llega un paquete a tu nombre, el guardia lo registra en caseta y tú lo ves en la pantalla "Mis Paquetes" con tres estados posibles:

• En caseta (recibido) — Llegó pero aún no te notifican
• Listo para recoger (notificado) — Pasa a caseta a recogerlo
• Entregado — Ya lo recogiste

Votaciones

Las Votaciones te permiten participar en decisiones del fraccionamiento. Pueden ser de tres tipos:

• Sí/No — Voto simple
• Múltiple — Selección entre varias opciones
• Encuesta — Recolección de opinión

Mensajes (Chat)

El Chat con administración es un canal directo 1:1 entre tú y el administrador del coto para consultas que no son anuncios masivos ni incidencias formales.

Glosario rápido

Término	Significado
Coto / Fraccionamiento	Conjunto residencial privado (un tenant del sistema)
Caseta	Punto de control de acceso
Bitácora	Registro cronológico de accesos y eventos
Permiso	Autorización con código QR para una visita
Multi-tenant	Un sistema que sirve a múltiples cotos de forma aislada