# Instalar y configurar un quiosco

> **Quién puede hacerlo:** administración.
> **Antes de empezar:** la ubicación tiene que existir, con coordenadas y código de establecimiento.
> **Tiempo estimado:** unos minutos por dispositivo.

## Lo que hay que tener listo antes

**Una ubicación creada**, con:
- **Coordenadas** del sitio — sin ellas no hay geocerca ni distancia.
- **Radio de tolerancia** en metros. Por defecto 50.
- **Código de establecimiento** — único en todo el sistema. Es la credencial con la que el quiosco se conecta.

**Las personas asignadas** a esa ubicación, si la vas a manejar como individual en vez de global.

**Los PIN generados**, si vas a usar esa modalidad.

## Cómo se conecta el quiosco

El dispositivo se "establece" contra una ubicación: se le indica la **unidad de negocio** y el **código de establecimiento**, y el sistema le entrega una sesión.

A partir de ahí el quiosco queda ligado a ese sitio. Todas las marcas que registre llevan esa ubicación.

<!-- 📷 IMAGEN: pantalla de configuración inicial del quiosco -->

<p class="callout info">💡 La unidad de negocio se deduce <strong>de la ubicación</strong>, no de quién configura el dispositivo. Por eso alcanza con el código.</p>

## El código de establecimiento es una credencial

<p class="callout danger">Quien tenga el código de establecimiento puede configurar un dispositivo contra esa ubicación. <strong>Tratalo como una contraseña.</strong></p>

En la práctica:

- No lo pegues en un papel visible junto al quiosco.
- No lo compartas por canales abiertos.
- Usá códigos largos y difíciles de adivinar, no `obra1`, `obra2`.
- Si un dispositivo se pierde o se roba, cambiá el código de esa ubicación.

## Qué recibe el quiosco al conectarse

Junto con la sesión, el dispositivo recibe la configuración de la empresa y **la lista de proyectos activos de esa ubicación**.

<p class="callout success">Por eso el quiosco puede atribuir las horas a un proyecto sin que nadie elija nada: ya sabe cuáles corresponden a ese sitio.</p>

## Los PIN

Si vas a usar marcaje por PIN, cada persona necesita el suyo.

**Formato:** seis dígitos, mostrados como `123-456`.

**Único por empresa** — dos personas de la misma unidad no pueden tener el mismo.

**Se asigna desde el sistema**, no lo elige la persona.

<p class="callout warning">Un PIN identifica a la persona <strong>por sí solo</strong>. Quien lo conozca puede marcar en su nombre.<br><br>Si tu operación necesita certeza de quién marcó, el PIN no alcanza: usá reconocimiento facial. El PIN es cómodo y rápido, pero es un secreto compartible.</p>

## Una ubicación, varios quioscos

Podés tener varios dispositivos con el mismo código, todos ligados a la misma ubicación. Útil cuando hay varias entradas a un mismo sitio.

## Recomendaciones de instalación

<p class="callout success"><strong>Luz de frente, no a contraluz.</strong> Es la causa número uno de fallas de reconocimiento facial. Evitá ponerlo con una ventana detrás.</p>

<p class="callout success"><strong>A la altura de la cara</strong> de una persona promedio, y con espacio para que alguien se pare de frente.</p>

<p class="callout success"><strong>Conexión estable.</strong> El reconocimiento facial consulta un servicio externo: sin red, no marca nadie.</p>

<p class="callout success"><strong>Un plan para cuando falle.</strong> Definí de antemano qué hace la gente si el quiosco no funciona — normalmente, que la jefatura registre las marcas después.</p>

## Antes de ponerlo en producción

Probá un día completo con una persona real: entrada, almuerzo y salida.

Verificá que las cuatro marcas quedaron registradas, con la ubicación correcta, la diferencia esperada, y —si aplica— atribuidas al proyecto correcto.

<p class="callout danger">Si el quiosco queda mal configurado, no lo vas a notar de inmediato: las marcas se registran igual. Lo vas a descubrir semanas después, cuando alguien revise el reporte y los números no cuadren.</p>