Cómo funciona el control de accesos en Boris

Boris no reemplaza a tu sistema de cerraduras: lo conduce. Vos seguís administrando el hardware en Kisi, Salto KS, Akiles, Tapkey, Brivo o Doordeck, y Boris se encarga de que cada reserva tenga acceso a la puerta correcta, en el horario correcto, y de quitarlo cuando termina.

El modelo en tres piezas

1. Puertas — Boris importa las puertas del proveedor y las guarda en su propia lista. Cada puerta se vincula a una sala, o se marca como zona común (entrada del edificio, baños, cocina) para que se abra en todas las reservas del espacio.
2. Accesos (grants) — cuando se confirma una reserva, Boris crea un acceso por cada puerta que corresponde: la sala reservada más todas las zonas comunes. El acceso tiene una ventana de validez que es el horario de la reserva más los minutos de margen que configures.
3. Eventos — si el proveedor lo permite, Boris trae de vuelta el registro de aperturas para que puedas ver quién entró y cuándo, sin salir de Boris.

Cuándo se da y se quita el acceso

Los cinco proveedores aceptan ventanas de validez, así que el horario lo hace cumplir la cerradura, no el cron de Boris. Si Boris se cae, nadie se queda con acceso eterno.

Margen antes y después

Cada integración tiene dos números: minutos de acceso antes de que empiece la reserva y minutos después de que termine (15 y 15 por defecto). Sirven para que alguien que llega diez minutos antes no se quede en la puerta, y para que quien está juntando sus cosas pueda salir.

Qué credencial recibe el cliente

• Link o QR de invitado (Kisi, Akiles): el cliente abre desde el navegador, no necesita instalar nada. Es lo habitual para pases de día y salas de reunión.
• PIN (Akiles, Brivo): un código numérico para el teclado de la puerta.
• Cuenta del proveedor (Tapkey, Salto KS, Doordeck, y Kisi en modo «share»): el acceso se asocia al email del cliente y se abre desde la app del proveedor. Requiere que el cliente tenga o cree esa cuenta.

Qué necesita cada reserva

• Una sala con puerta vinculada (o al menos una zona común mapeada).
• El email del cliente, si el proveedor entrega el acceso por cuenta (Tapkey, Doordeck, Salto KS). Sin email, el acceso queda en estado «falló» con el motivo explicado.

Si algo falla

Un acceso que no se pudo emitir queda como pendiente o falló, con el mensaje exacto del proveedor. No bloquea la reserva: la reserva se guarda igual. El cron cron/access_control_jobs.php reintenta hasta cinco veces, y en la pantalla de la integración tenés un botón «Reintentar» para forzarlo. Ese mismo cron:

• emite accesos de reservas que se hicieron antes de que mapearas la puerta (mira 48 horas hacia adelante),
• revoca los accesos vencidos,
• importa los eventos de puerta.

Programalo cada 5 minutos:

*/5 * * * * php /ruta/a/boris/cron/access_control_jobs.php

Probar sin abrir puertas de verdad

Cada integración tiene dos herramientas pensadas para que no estrenes esto con un cliente real esperando en la calle.

Modo simulación

Con el modo simulación activado, Boris ejecuta exactamente el mismo código que en producción, pero no envía nada al proveedor: guarda las peticiones que habría hecho y te las muestra en la tabla de accesos, bajo «Peticiones que enviaría». Los accesos quedan en estado Simulado.

Sirve para tres cosas:

• ver el circuito completo (reserva → acceso → cancelación) sin credenciales reales,
• hacer una demo comercial sin hardware,
• que un coworking piloto vea qué pasaría antes de activar de verdad.

Mientras el modo simulación está activo, importar puertas queda deshabilitado: el proveedor no respondería nada y se desactivarían todas las puertas reales.

Acceso de prueba

El botón «Emitir acceso de prueba» crea un acceso corto (por defecto 10 minutos) sobre una puerta, con el email que elijas y sin ninguna reserva detrás. Es la forma más rápida de comprobar la cadena entera —credenciales, permisos, entrega de la credencial— en cuanto conectás un proveedor nuevo.

Recomendación: la primera prueba real hacela siempre contra una puerta secundaria (un trastero, una sala chica), nunca la entrada principal.

Lo que Boris crea dentro de tu proveedor

Para poder dar acceso a una puerta puntual sin tocar los permisos de nadie, Boris crea sus propios objetos, siempre con el prefijo «Boris · » en el nombre. No los renombres ni los borres a mano: son grupos de acceso, miembros de invitado y credenciales temporales. Si borrás uno, Boris lo vuelve a crear en el siguiente acceso.

Límites conocidos

• Boris no gestiona el alta de hardware, ni firmware, ni cableado: eso sigue en el panel del proveedor.
• La apertura remota desde Boris existe donde el proveedor la ofrece (Kisi, Akiles, Salto KS, Brivo, Doordeck). Tapkey es Bluetooth y se abre desde el móvil del usuario.
• Los accesos por membresía recurrente todavía no se emiten solos: se emiten por reserva. Para un socio con abono mensual, la vía actual es una reserva recurrente.