# DIGITAL ONE - Manual del Usuario

**Version:** 8.0
**Fecha:** 2026-04-02

---

## INDICE

1. [Introduccion](#1-introduccion)
2. [Instalacion](#2-instalacion)
   - [Instalador Completo (Local)](#21-instalador-completo-local)
   - [Instalador Liviano (Nube)](#22-instalador-liviano-nube)
3. [Primeros Pasos](#3-primeros-pasos)
4. [Digital One Fichador](#4-digital-one-fichador)
5. [Digital One Administrador](#5-digital-one-administrador)
6. [Portal Web Digital One](#6-portal-web-digital-one)
7. [Modulo Facial (Digital Face)](#7-modulo-facial-digital-face)
8. [Digital One Mobile (PWA)](#8-digital-one-mobile-pwa)
9. [Sistema de Licencias y Planes](#9-sistema-de-licencias-y-planes)
10. [Preguntas Frecuentes](#10-preguntas-frecuentes)
11. [Soporte Tecnico](#11-soporte-tecnico)

---

## 1. INTRODUCCION

### Que es Digital One

Digital One es un sistema de **control de asistencia y gestion de personal** que permite registrar los ingresos y egresos del personal de su empresa. El sistema funciona mediante:

- **Huella digital:** El empleado apoya su dedo en un lector USB y el sistema lo identifica automaticamente.
- **PIN:** El empleado ingresa su numero de legajo y un codigo PIN personal.
- **Movil:** El empleado ficha desde su smartphone accediendo a la PWA del portal, con validacion de ubicacion GPS.
- **QR:** El empleado escanea un codigo QR generado desde el portal.
- **Reconocimiento facial:** Terminales de acceso facial Hikvision (requiere modulo Digital Face).
- **Modo demostracion:** Para pruebas sin necesidad de hardware.

### Componentes del sistema

Digital One se compone de las siguientes aplicaciones:

| Aplicacion | Funcion |
|---|---|
| **Digital One Fichador** | Terminal de fichaje donde los empleados registran entrada y salida (huella, PIN, QR, demo) |
| **Digital One Administrador** | Aplicacion de gestion: legajos, huellas, foto, configuracion PIN, noticias, licencia |
| **Portal Web Digital One** | Acceso via navegador: dashboard, fichadas, reportes, estructura, administracion completa |
| **Digital One Mobile** | PWA de smartphone para fichada con validacion de ubicacion GPS |
| **FaceAgent** | Aplicacion desktop on-premise que conecta terminales faciales Hikvision con el portal (modulo Digital Face) |

### Requisitos del equipo

| Requisito | Detalle |
|---|---|
| Sistema operativo | Windows 10 o Windows 11 (64 bits) |
| .NET Framework | 4.8 o superior (normalmente ya incluido en Windows 10/11) |
| Permisos | **Administrador local** para instalar |
| Lector de huellas | DigitalPersona uAreU 4500 (opcional si usa PIN) |
| Conexion a internet | Requerida para instalacion en nube; opcional para local |

---

## 2. INSTALACION

Digital One cuenta con **dos instaladores** segun el tipo de despliegue:

| Instalador | Tamano | Para quien |
|---|---|---|
| **Instalador Completo** | ~180 MB | Empresas que quieren su propia base de datos local |
| **Instalador Liviano** | ~25 MB | Empresas que usan la base de datos en la nube |

> **Nota:** Ambos instaladores instalan Fichador y Administrador juntos. La diferencia es donde se ubica la base de datos.

---

### 2.1 Instalador Completo (Local)

Este instalador crea todo lo necesario en su propio equipo, incluyendo SQL Server Express si no lo tiene instalado.

#### Paso 1 - Ejecutar el instalador

Haga doble clic en el archivo:
```
DigitalOne_Suite_Setup.exe
```

Si Windows muestra una advertencia de seguridad, haga clic en **Si**.

> [CAPTURA: Pantalla de UAC de Windows pidiendo permisos de administrador]

#### Paso 2 - Pantalla de bienvenida

Haga clic en **Siguiente**.

> [CAPTURA: Pantalla de bienvenida del instalador con logo Digital One]

#### Paso 3 - Seleccionar modo de instalacion

El instalador le preguntara como desea configurar la base de datos:

- **Local:** Instala SQL Server Express en su equipo (recomendado para empresas pequenas)
- **Nube:** Conecta con una base de datos remota usando un codigo de activacion

Seleccione **Local** y haga clic en **Siguiente**.

> [CAPTURA: Pantalla de seleccion de modo LOCAL / NUBE]

#### Paso 4 - Instalacion de SQL Server Express (solo modo Local)

Si su equipo no tiene SQL Server Express instalado, el instalador lo descargara e instalara automaticamente. Este proceso puede tomar entre **5 y 15 minutos** dependiendo de su equipo.

> [CAPTURA: Barra de progreso instalando SQL Server Express]

Si ya tiene SQL Server Express, este paso se omite automaticamente.

#### Paso 5 - Configuracion de base de datos (modo Local)

El instalador creara automaticamente la base de datos con todas las tablas necesarias.

> [CAPTURA: Pantalla de progreso creando la base de datos]

#### Paso 6 - Accesos directos

Seleccione las opciones deseadas:
- Crear acceso directo en el Escritorio para **Fichador** (recomendado)
- Crear acceso directo en el Escritorio para **Administrador** (recomendado)
- Iniciar automaticamente con Windows (opcional)

> [CAPTURA: Pantalla de seleccion de accesos directos y opciones]

#### Paso 7 - Instalacion

Haga clic en **Instalar** y espere a que finalice. Durante la instalacion vera:
- Copia de archivos
- Instalacion del driver DigitalPersona (lector de huellas)
- Configuracion de la base de datos
- Cifrado de configuracion de seguridad

> [CAPTURA: Barra de progreso de la instalacion]

#### Paso 8 - Finalizacion

Haga clic en **Finalizar**. Opcionalmente puede marcar ejecutar las aplicaciones inmediatamente.

> [CAPTURA: Pantalla de finalizacion del instalador]

---

### 2.2 Instalador Liviano (Nube)

Este es el instalador recomendado para la mayoria de las empresas. La base de datos esta alojada en la nube (no se necesita instalar nada de SQL Server en su equipo). Es rapido y liviano (~25 MB), pero requiere un **codigo de activacion** proporcionado por el administrador del sistema.

#### Que necesita antes de empezar

1. El archivo del instalador: `DigitalOne_Cloud_Setup.exe`
2. El **codigo de activacion** de su empresa (proporcionado por su proveedor)
3. Conexion a internet (obligatoria durante la instalacion)

#### Paso 1 - Ejecutar el instalador

Haga doble clic en el archivo `DigitalOne_Cloud_Setup.exe`. Si Windows muestra una advertencia de seguridad (SmartScreen o UAC), haga clic en **Mas informacion** y luego en **Ejecutar de todas formas**, y luego **Si** en la pantalla de permisos de administrador.

> [CAPTURA: Pantalla de UAC de Windows]

#### Paso 2 - Pantalla de bienvenida

Lea la informacion y haga clic en **Siguiente**.

> [CAPTURA: Pantalla de bienvenida del instalador liviano]

#### Paso 3 - Accesos directos y opciones

Seleccione las opciones deseadas:
- **Crear acceso directo en el Escritorio para Fichador** (recomendado para terminales de fichaje)
- **Crear acceso directo en el Escritorio para Administrador** (recomendado para el puesto de administracion)
- **Iniciar Fichador automaticamente al encender** (recomendado para terminales que siempre deben estar activas)
- **Iniciar Administrador automaticamente al encender** (opcional)

Haga clic en **Siguiente**.

> [CAPTURA: Pantalla de seleccion de accesos directos]

#### Paso 4 - Codigo de Activacion

Esta es la pantalla mas importante del proceso.

1. Escriba o pegue el **codigo de activacion** en el campo de texto. El codigo tiene formato `XXXX-XXXX-XXXX-XXXX-XXXX-XXXX` (puede variar en longitud).
2. Haga clic en el boton **Validar Codigo**
3. Espere la respuesta del servidor (requiere internet):
   - **Verde:** "Codigo valido. Empresa: [nombre de su empresa]" — Puede continuar con la instalacion
   - **Rojo:** "Codigo invalido o expirado" — Verifique que el codigo este bien escrito. Si persiste, contacte a su proveedor.

> [CAPTURA: Pantalla de ingreso de codigo de activacion con campo de texto y boton Validar]

> **Importante:** Sin un codigo valido no podra continuar con la instalacion. Si no tiene el codigo, contacte al administrador del sistema. Cada codigo esta asociado a una empresa especifica.

#### Paso 5 - Instalacion

Haga clic en **Instalar**. El instalador realizara automaticamente:
- Copia de archivos del Fichador y Administrador
- Instalacion del driver del lector de huellas DigitalPersona
- Configuracion de la conexion a la base de datos en la nube (usando el codigo validado)
- Cifrado de la configuracion de seguridad (proteccion DPAPI)

> [CAPTURA: Progreso de instalacion liviana]

#### Paso 6 - Finalizacion

Haga clic en **Finalizar**. Opcionalmente puede marcar ejecutar las aplicaciones inmediatamente.

#### Que sucede automaticamente despues de instalar

Al abrir el **Fichador** por primera vez, el sistema realiza un **auto-registro de la terminal**: detecta el nombre de la computadora y la registra automaticamente en la base de datos, asociandola a la sucursal principal de su empresa. **No es necesario dar de alta la computadora manualmente** desde el portal web ni desde el Administrador.

Si necesita cambiar la sucursal asignada a una terminal, puede hacerlo desde el **Portal Web** en la seccion **Terminales**.

---

### Conectar el lector de huellas (post-instalacion)

**Despues** de instalar, conecte el lector DigitalPersona uAreU 4500 al puerto USB. Windows instalara los drivers automaticamente (ya fueron incluidos durante la instalacion).

> [CAPTURA: Foto del lector DigitalPersona uAreU 4500 conectado a USB]

Si el lector ya estaba conectado antes de instalar, desconectelo y vuelva a conectarlo.

---

## 3. PRIMEROS PASOS

### Orden recomendado de configuracion

1. Abra **Digital One Administrador**
2. Configure los datos basicos: Sucursales, Categorias, Horarios, Sectores
3. Cargue los **Legajos** (empleados) — puede tomarles foto con la camara web
4. Registre las **huellas digitales** de cada empleado (o asigne PINs)
5. Abra **Digital One Fichador** en la terminal de fichaje — la computadora se registra automaticamente como terminal asociada a la sucursal principal
6. Pruebe fichando con un empleado registrado

> **Nota:** No es necesario registrar las terminales (computadoras de fichaje) manualmente. El Fichador las registra automaticamente la primera vez que se ejecuta en cada computadora.

---

## 4. DIGITAL ONE FICHADOR

### Pantalla principal

Al abrir el Fichador, vera la pantalla de fichaje con:
- Nombre de la sucursal asignada
- Reloj con fecha y hora actual
- Area de semaforo visual (verde = OK, rojo = error, amarillo = procesando)
- Panel de fichada (segun el modo activo)

> [CAPTURA: Pantalla principal del Fichador mostrando sucursal, reloj y semaforo]

### 4.1 Fichada por Huella Digital

Este es el modo principal si tiene un lector de huellas conectado.

1. El empleado apoya su dedo en el lector
2. El semaforo cambia a **amarillo** (procesando)
3. Resultado:
   - **Verde:** Fichada registrada exitosamente. Muestra nombre del empleado y tipo (Entrada/Salida)
   - **Rojo:** Huella no reconocida. El empleado debe volver a intentar.

> [CAPTURA: Fichador mostrando semaforo verde con nombre del empleado y "ENTRADA" o "SALIDA"]

> [CAPTURA: Fichador mostrando semaforo rojo indicando huella no reconocida]

### 4.2 Fichada por PIN

Si no hay lector de huellas o si el modo PIN esta habilitado:

1. El empleado ingresa su **numero de legajo**
2. Ingresa su **PIN** de 4 a 6 digitos
3. El sistema valida y registra la fichada

> [CAPTURA: Panel de fichada por PIN mostrando campo de legajo y campo de PIN]

#### Primera vez (sin PIN asignado)

Si el legajo no tiene un PIN asignado, el sistema le preguntara **"Desea crear uno ahora?"** con botones **Si** y **No**. Si acepta, se abre el formulario de creacion de PIN donde debe:

1. Ingresar un nuevo PIN (4 a 6 digitos)
2. Confirmar el nuevo PIN

Si elige **No**, puede fichar de otra manera (huella) o volver mas tarde.

> [CAPTURA: Dialogo preguntando si desea crear un PIN con botones Si/No]

> [CAPTURA: Formulario de creacion de PIN con campos: Nuevo PIN, Confirmar PIN]

#### Cambio forzado por el administrador

Si el administrador marco "Forzar cambio de PIN" para el empleado, al ingresar su numero de legajo el sistema muestra un mensaje **obligatorio**: **"El administrador requiere que cambie su PIN"** con un unico boton **OK**. No hay opcion de cancelar ni de omitir el cambio. Al presionar OK, se abre directamente el formulario de creacion de PIN **sin pedir el PIN anterior**.

Si el administrador "Reseteo" el PIN (lo elimino), el comportamiento es igual al de "Primera vez" descrito arriba (ofrece crear uno nuevo con Si/No).

> [CAPTURA: Mensaje obligatorio "El administrador requiere que cambie su PIN" con boton OK]

> [CAPTURA: Formulario de nuevo PIN sin campo de PIN anterior]

#### PIN expirado

Si el PIN del empleado esta vencido, al ingresar el legajo y el PIN actual correctamente, el sistema le solicitara que cree un nuevo PIN antes de completar la fichada.

> [CAPTURA: Mensaje de PIN expirado con formulario de cambio de PIN]

#### Cambiar PIN

Existen **dos formas** de cambiar el PIN:

**1. Cambio voluntario - Link "Cambiar mi PIN"**

En la pantalla de fichada hay un link **"Cambiar mi PIN"** que abre un formulario donde el empleado debe ingresar:

1. Numero de legajo
2. PIN actual
3. Nuevo PIN (minimo 4 digitos)
4. Confirmar nuevo PIN

El sistema valida que el PIN actual sea correcto, que el nuevo PIN tenga al menos 4 digitos y que sea diferente al PIN actual.

> [CAPTURA: Link "Cambiar mi PIN" en la pantalla de fichada]

> [CAPTURA: Formulario de cambio voluntario de PIN con campos: Legajo, PIN actual, Nuevo PIN, Confirmar PIN]

**2. Cambio forzado por el administrador**

Cuando el administrador marca "Forzar cambio" o "Resetear PIN" desde la pestana de PINs en Configuracion, la proxima vez que el empleado ingrese su numero de legajo en el Fichador, el sistema lo lleva directamente al formulario de creacion de PIN sin pedir el PIN anterior (ver seccion "Cambio forzado por el administrador" mas arriba).

### 4.3 Fichada por QR

Si el modo QR esta habilitado, el empleado puede presentar su codigo QR personal (generado desde el portal) ante la camara o lector de la terminal.

### 4.4 Modo Demostracion

Este modo permite fichadas sin hardware biometrico ni PIN. Solo para demostraciones.

1. Se muestra una lista de empleados
2. El operador selecciona el empleado
3. Se registra la fichada

> [CAPTURA: Panel de modo demostracion con lista de empleados]

### 4.5 Deteccion automatica de modo

El Fichador detecta automaticamente si hay un lector de huellas conectado:
- **Lector detectado:** Usa modo Huella
- **Sin lector + PIN habilitado:** Cambia automaticamente a modo PIN
- **Sin lector + Demo habilitado:** Cambia a modo Demo
- Si se desconecta el lector durante el uso, cambia de modo en tiempo real

### 4.6 Registro automatico de terminal y sucursal

Al ejecutarse por primera vez en una computadora, el Fichador registra automaticamente la terminal en el sistema, asociandola a la sucursal principal de la empresa. El nombre de la terminal corresponde al nombre de la computadora. Puede cambiar la sucursal asignada desde el Portal Web en la seccion Terminales.

### 4.7 Informacion de licencia

En la barra inferior del Fichador se muestra informacion segun el tipo de instalacion:

**Instalacion local:**
- Tipo de licencia (Trial / Activa)
- Dias restantes (si es trial)
- Plan contratado

**Instalacion multi-tenant (nube):**
- La barra muestra la informacion del **terminal/sucursal**. El terminal se identifica por el nombre de la maquina y se registra automaticamente en la primera ejecucion.
- Ejemplo: **"10 - Administracion Dardo Rocha"** muestra el ID de la sucursal y su nombre.
- Si la terminal no aparece asociada a ninguna sucursal, verifique la conexion a la base de datos.

> [CAPTURA: Barra de estado inferior mostrando informacion de licencia (instalacion local)]

> [CAPTURA: Barra de estado inferior mostrando terminal y sucursal (instalacion nube)]

---

## 5. DIGITAL ONE ADMINISTRADOR

### Pantalla principal

Al abrir el Administrador, el usuario inicia sesion con su **email** registrado en el sistema. Una vez dentro, vera un menu lateral con todas las opciones disponibles. En la parte superior del menu se muestra el **logo de su empresa** (si fue cargado). En la parte inferior del menu aparece el logo de Integra IA.

El menu incluye accesos directos a las **redes sociales y pagina web** de su empresa (si fueron configuradas). Estos links abren el navegador web al hacer clic.

> [CAPTURA: Pantalla principal del Administrador con menu lateral, logo de empresa y links de redes sociales]

### 5.1 Gestion de Legajos (Empleados)

Desde **RRHH > Legajos** puede:

- **Agregar** un nuevo empleado: nombre, legajo, categoria, horario, sector, sucursal
- **Modificar** datos de un empleado existente
- **Eliminar** un empleado (baja logica)
- **Tomar foto** del empleado usando la camara web
- **Registrar huellas** digitales (enrollment DigitalPersona, requiere lector conectado)
- **Asignar/Resetear PIN**

> [CAPTURA: Formulario de Legajos mostrando los campos de datos del empleado]

#### Registrar huellas

1. Seleccione el empleado en la lista
2. Haga clic en el boton de huella
3. Siga las instrucciones del asistente de enrolamiento DigitalPersona
4. Apoye el mismo dedo 4 veces para capturar la huella
5. Repita con otro dedo si lo desea

> [CAPTURA: Dialogo de enrolamiento de huellas digitales]

#### Configurar PIN

1. Seleccione el empleado en la lista
2. Haga clic en el boton **PIN**
3. Ingrese un PIN de 4 a 6 digitos
4. Confirme el PIN

> [CAPTURA: Dialogo de asignacion de PIN con campo de ingreso]

### 5.2 Gestion de Fichadas

Desde **RRHH > Fichadas** puede:

- Ver todas las fichadas registradas
- Filtrar por empleado, fecha, tipo (Entrada/Salida)
- Agregar fichadas manuales (en caso de olvido del empleado)
- Ver llegadas tarde

> [CAPTURA: Pantalla de consulta de fichadas con filtros y grilla de datos]

### 5.3 Tablas del Sistema

| Opcion | Que gestiona |
|---|---|
| **Sucursales** | Ubicaciones fisicas de la empresa |
| **Categorias** | Clasificacion de empleados (ej: Operario, Administrativo) |
| **Horarios** | Definicion de horarios de trabajo |
| **Sectores** | Areas de la empresa (ej: Produccion, RRHH) |
| **Incidencias** | Tipos de ausencia (vacaciones, enfermedad, permiso) |
| **Feriados** | Dias no laborables |

> [CAPTURA: Pantalla de ABM de Sucursales como ejemplo de tabla del sistema]

### 5.4 Configuracion del Sistema

Desde el boton de **Configuracion** (icono de engranaje) accede a:

#### Pestana Fichada
- **Modo PIN:** Habilitar o deshabilitar fichada por PIN
- **Expiracion de PIN:** Cantidad de dias para que el PIN expire (0 = no expira)
- **Modo Demo:** Habilitar o deshabilitar modo demostracion

> [CAPTURA: Pantalla de Configuracion - Pestana Fichada con checkboxes y opciones]

#### Pestana PINs
Muestra **todos los legajos** con su estado de PIN. En la parte superior hay un combo de filtro con las siguientes opciones:

- **Todos:** Muestra todos los legajos
- **Con PIN activo:** Solo legajos con PIN vigente
- **Sin PIN:** Legajos que no tienen PIN asignado
- **Vencidos:** Legajos cuyo PIN ha expirado
- **Cambio pendiente:** Legajos a los que el administrador les forzo un cambio de PIN

> [CAPTURA: Pantalla de Configuracion - Pestana PINs con combo de filtro y grilla]

La grilla muestra las siguientes columnas:

| Columna | Descripcion |
|---|---|
| **Legajo** | Numero de legajo del empleado |
| **Nombre** | Nombre completo del empleado |
| **Estado PIN** | Activo / Sin PIN / Vencido / Cambio pendiente |
| **Ultimo cambio** | Fecha del ultimo cambio de PIN |

Debajo de la grilla hay dos botones de accion:

- **Forzar cambio de PIN:** Marca los legajos seleccionados con PinMustChange. La proxima vez que el empleado ingrese su numero de legajo en el Fichador, debera establecer un nuevo PIN. No se le pedira el PIN anterior.
- **Resetear PIN:** Elimina el PIN del empleado por completo. La proxima vez que ingrese su legajo en el Fichador, se le solicitara que cree un PIN nuevo. Use esta opcion cuando un empleado olvido su PIN.

> [CAPTURA: Botones "Forzar cambio de PIN" y "Resetear PIN" en la pestana PINs]

### 5.5 Noticias

El Administrador permite gestionar **noticias** que se muestran a los empleados en las terminales de fichaje. Las noticias pueden incluir titulo, texto y fecha de vigencia.

### 5.6 Reportes

El Administrador genera reportes con Microsoft ReportViewer:
- Asistencia por periodo
- Horas trabajadas
- Llegadas tarde
- Horas extras

Los reportes se pueden exportar a PDF y Excel.

> [CAPTURA: Ejemplo de reporte de asistencia generado]

### 5.7 Licencias

Desde el menu **Licencias** puede:
- Ver el estado actual de la licencia
- Ingresar un codigo de activacion para pasar de Trial a licencia completa
- Ver detalles: plan, legajos permitidos, vencimiento

> [CAPTURA: Pantalla de informacion de licencia en el Administrador]

---

## 6. PORTAL WEB DIGITAL ONE

### Acceso

Abra su navegador web y vaya a la direccion proporcionada por su administrador (ejemplo: `https://digitalone-portal.azurewebsites.net/`).

Ingrese sus credenciales de acceso (email y contrasena). El boton de inicio de sesion se deshabilita automaticamente mientras se procesa para evitar errores por doble clic.

> [CAPTURA: Pantalla de login del portal web]

### Primer inicio de sesion

Si es la primera vez que accede (con la contrasena temporal proporcionada por el administrador), el sistema le pedira que **cambie su contrasena** obligatoriamente antes de poder usar el portal. Ingrese una nueva contrasena y confirmela. Esta pantalla no se puede omitir ni navegar a otra seccion hasta completar el cambio.

> [CAPTURA: Pantalla de cambio obligatorio de contrasena]

### Empresa suspendida

Si al intentar iniciar sesion recibe el mensaje **"El acceso a su empresa ha sido suspendido"**, significa que el administrador del sistema ha desactivado temporalmente el acceso. Contacte a su proveedor para resolver la situacion. Lo mismo aplica a las aplicaciones de escritorio (Fichador y Administrador): si la empresa esta suspendida, las apps mostraran un aviso y se cerraran.

### Barra superior

Una vez dentro del portal, en la **barra superior** se muestra:
- **Lado izquierdo:** El logo y nombre de su empresa
- **Lado derecho:** El identificador de empresa y el nombre del usuario logueado, con menu desplegable para acceder a configuracion de cuenta y cerrar sesion

> [CAPTURA: Barra superior del portal con logo de empresa a la izquierda y datos de usuario a la derecha]

### 6.1 Dashboard

La pagina principal del portal muestra un panel con indicadores clave del dia:

- **KPIs principales:** Presentes, Ausentes, Tardes, Total de fichadas del dia
- **Grafico de asistencia semanal:** Barras comparativas de los ultimos 7 dias
- **Fichadas por hora:** Distribucion horaria de las fichadas del dia
- **Estado del dia:** Resumen visual del dia actual
- **Ultimas fichadas:** Lista en tiempo real de las fichadas mas recientes
- **Noticias:** Ultimas noticias publicadas por la empresa

Si la empresa tiene el **modulo Digital Face habilitado**, el dashboard incluye ademas:
- Terminales faciales online
- Accesos faciales del dia
- Accesos denegados
- No reconocidos

> [CAPTURA: Dashboard del portal con KPIs, graficos y fichadas recientes]

### 6.2 Legajos

Gestion completa de empleados con las siguientes funcionalidades:

- **CRUD completo:** Crear, ver, editar y eliminar legajos
- **Importar desde Excel:** Carga masiva de legajos usando una plantilla descargable (.xlsx)
- **Exportar a Excel/CSV:** Descarga de la lista de legajos
- **Eliminar:** Solo si el legajo no tiene fichadas, rostros ni eventos faciales asociados
- **Asignacion de sucursales:** Cada legajo se asigna a sucursales con permisos de fichada
- **Credenciales QR:** Impresion de credencial con codigo QR para fichada
- **Foto:** Carga de foto del empleado
- **PIN movil:** Configuracion del PIN para fichada desde la app movil

> [CAPTURA: Lista de legajos con opciones de importar, exportar y filtros]

### 6.3 Fichadas

Lista de todas las fichadas registradas con filtros avanzados:

- **Filtros:** Rango de fecha, sucursal, legajo, tipo (Entrada/Salida), origen
- **Crear fichada manual:** Para registrar fichadas olvidadas
- **Editar:** Modificar fichadas existentes
- **Eliminar:** Borrar fichadas erroneas

> [CAPTURA: Lista de fichadas con filtros y acciones]

### 6.4 Registro de Accesos

Vista unificada que combina fichadas tradicionales (huella, PIN, QR, movil) con eventos de acceso facial. Incluye:

- **Filtros por origen:** Huella, PIN, QR, Facial, Movil, Manual, etc.
- **Paginacion:** Navegacion por paginas para grandes volumenes de datos
- **Exportar:** Descarga en Excel y CSV

Esta vista es ideal para empresas que combinan multiples metodos de fichaje y necesitan una vision consolidada de todos los accesos.

> [CAPTURA: Registro de accesos unificado con filtros por origen]

### 6.5 Reportes

Cinco reportes disponibles, todos exportables a Excel y CSV:

| Reporte | Descripcion |
|---|---|
| **Asistencia Diaria** | Presentes y ausentes por dia, con detalle de horarios |
| **Ausencias** | Listado de ausencias por periodo con tipo de incidencia |
| **Horas Trabajadas** | Calculo de horas por empleado y periodo |
| **Llegadas Tarde** | Detalle de llegadas tarde con minutos de diferencia |
| **Recorrido Diario** | Todas las fichadas del dia ordenadas cronologicamente |

Si el modulo Digital Face esta habilitado, los reportes incorporan automaticamente datos de acceso facial (primer evento facial = Entrada, ultimo = Salida).

> [CAPTURA: Ejemplo de reporte con filtros y boton de exportacion]

### 6.6 Estructura organizativa

#### Sucursales
Gestion de ubicaciones fisicas de la empresa. Incluye **geoconfiguracion con mapa**: se muestra un mapa interactivo (Leaflet) donde puede buscar la direccion por geocodificacion (Nominatim) o marcar manualmente la ubicacion para definir las coordenadas de la sucursal. Estas coordenadas se usan para validar la ubicacion GPS en fichadas moviles.

#### Sectores
Areas o departamentos de la empresa (ej: Produccion, RRHH, Sistemas).

#### Categorias
Clasificacion de empleados (ej: Operario, Administrativo, Gerencia).

#### Horarios
Definicion de horarios de trabajo con **detalle por dia** de la semana. Cada dia puede tener hora de entrada, salida y tolerancia.

> [CAPTURA: Formulario de sucursal con mapa interactivo]

### 6.7 Operacion diaria

| Seccion | Descripcion |
|---|---|
| **Incidencias** | Carga de ausencias justificadas (enfermedad, permiso, etc.) |
| **Vacaciones** | Gestion de periodos de vacaciones por empleado |
| **Calendario** | Vista calendario con fichadas, incidencias y feriados |
| **Feriados** | ABM de dias feriados |
| **Noticias** | Publicacion de noticias visibles en terminales y dashboard |
| **Variables del sistema** | Parametros de configuracion general |

### 6.8 Administracion

#### Empresa
Configuracion general de la empresa: datos, logo, modulos habilitados.

#### Planes y facturacion
Visualizacion del plan actual, limites de uso y facturacion. Pago integrado con **MercadoPago** (para planes de pago).

#### Usuarios
Gestion de usuarios del portal con:
- **Roles:** Administrador, Operador, Consulta
- **Permisos por sucursal:** Cada usuario puede estar asociado a una o mas sucursales, limitando la visibilidad de fichadas y reportes a esas sucursales

#### QR Fichada Movil
Configuracion de la fichada via QR desde terminales fijas. Generacion e impresion de codigos QR para cada legajo.

#### Terminales
Listado de terminales de fichaje registradas (computadoras con Fichador). Permite cambiar la sucursal asignada a cada terminal.

#### Terminales Moviles
Gestion de dispositivos moviles registrados para fichada. Generacion de codigos de activacion.

#### Auditoria
Registro de acciones realizadas por los usuarios del portal (quien hizo que y cuando).

> [CAPTURA: Panel de administracion con opciones de empresa, usuarios y auditoria]

---

## 7. MODULO FACIAL (DIGITAL FACE)

### Que es Digital Face

Digital Face es el modulo de **reconocimiento facial** de Digital One. Permite controlar el acceso mediante terminales faciales Hikvision, sin necesidad de contacto fisico. Este modulo esta **incluido en los planes Pro y Enterprise**.

Las funcionalidades faciales aparecen automaticamente en el portal cuando la empresa tiene terminales o agentes faciales configurados.

### 7.1 Terminales Faciales

Gestion de terminales de acceso facial Hikvision:

- **CRUD completo:** Alta, edicion y eliminacion de terminales
- **Test de conexion:** Verificar conectividad con la terminal desde el portal
- **Datos de conexion:** IP, puerto, usuario y contrasena de cada terminal
- **Asociacion a sucursal:** Cada terminal se asigna a una sucursal; solo recibe los legajos de esa sucursal

### 7.2 Rostros

Gestion de fotos de rostro para reconocimiento facial:

- **Carga de foto:** Desde la ficha del legajo (pestana Facial), puede subir la foto del rostro
- **Redimensionamiento automatico:** Las fotos se ajustan automaticamente al tamano requerido por Hikvision (maximo 95 KB)
- **Sincronizacion masiva (bulk sync):** Enviar todos los rostros a todas las terminales de la sucursal

### 7.3 FaceAgent (App Desktop On-Premise)

FaceAgent es una aplicacion de escritorio que se instala en un equipo dentro de la red local de la empresa, en la misma red que las terminales faciales. Funciona como puente entre el portal en la nube y las terminales Hikvision.

- Se conecta al portal via API segura
- Ejecuta los comandos de sincronizacion enviados desde el portal
- Reporta el estado de cada operacion en tiempo real
- Debe estar ejecutandose para que la sincronizacion funcione

### 7.4 Eventos de Acceso Facial

Los eventos de acceso (persona reconocida, acceso denegado, persona no reconocida) se registran automaticamente y se muestran en:
- El dashboard (KPIs faciales)
- El registro de accesos (vista unificada)
- Los reportes (datos faciales integrados)

### 7.5 Puertas y Permisos

Configuracion de puertas fisicas asociadas a las terminales faciales. Permite definir que legajos tienen acceso a que puertas.

### 7.6 Visitas y Blacklist

- **Visitas:** Registro de visitantes temporales con acceso por reconocimiento facial
- **Blacklist:** Lista de personas con acceso denegado. Si una terminal detecta un rostro en la blacklist, deniega el acceso y genera una alerta

### 7.7 Sincronizacion

El modulo facial utiliza un sistema de sincronizacion hibrido:

| Tipo | Descripcion |
|---|---|
| **syncPersons (bulk)** | Sincroniza todos los legajos y rostros de una sucursal a sus terminales. Usa delta sync para enviar solo los cambios |
| **syncPerson (individual)** | Sincroniza un legajo individual a las terminales de su sucursal. Util despues de cargar un nuevo rostro |
| **Delta sync** | Compara los legajos del portal con los de la terminal y solo envia las diferencias (altas, bajas, modificaciones) |

La sincronizacion se inicia desde el portal y se ejecuta a traves del FaceAgent. El estado de cada operacion se actualiza en tiempo real en la interfaz del portal.

> [CAPTURA: Pestana Facial del legajo mostrando foto, estado de sync por terminal y boton sincronizar]

---

## 8. DIGITAL ONE MOBILE (PWA)

### Que es

Digital One Mobile es una **Progressive Web App (PWA)** que permite a los empleados fichar desde su smartphone. No requiere instalacion desde una tienda de aplicaciones: se accede desde el navegador y se puede agregar a la pantalla de inicio.

### 8.1 Onboarding

Al acceder por primera vez, el empleado recorre un proceso de **3 pasos**:

1. **Bienvenida:** Presentacion de la app y sus funcionalidades
2. **Permisos:** Solicitud de acceso a ubicacion GPS
3. **Activacion:** Ingreso del codigo de activacion proporcionado por el administrador

### 8.2 Fichada con GPS

Al fichar, la app:

- Valida la **ubicacion GPS** del empleado contra las coordenadas de la sucursal
- Detecta automaticamente la **sucursal mas cercana** (si hay varias configuradas)
- Permite seleccionar **tipo de fichada:** Entrada o Salida
- Muestra confirmacion visual con los datos de la fichada

### 8.3 Historial

El empleado puede ver su historial de fichadas con:
- Fecha y hora de cada fichada
- Tipo (Entrada/Salida)
- Sucursal detectada al momento de fichar

### 8.4 Multi-empresa

Si el empleado trabaja en mas de una empresa, puede cambiar de empresa dentro de la app sin necesidad de cerrar sesion.

### 8.5 Instalar en pantalla de inicio

La app muestra un **banner A2HS** (Add to Home Screen) que invita al empleado a agregar Digital One Mobile a la pantalla de inicio de su telefono para acceso rapido, similar a una app nativa.

---

## 9. SISTEMA DE LICENCIAS Y PLANES

> **Nota importante:** En instalaciones **multi-tenant (nube)**, el sistema de licencias funciona de manera diferente. La activacion se realiza durante la instalacion mediante el codigo de activacion. Las aplicaciones de escritorio **no validan licencias al iniciar** - se conectan directamente a la base de datos en la nube. El sistema de trial y licencias descrito a continuacion aplica **unicamente a instalaciones LOCALES**.

### Periodo de prueba (Trial)

Al instalar Digital One por primera vez en modo local, el sistema se activa en **modo Trial** automaticamente:

| Limitacion | Valor |
|---|---|
| Duracion | 14 dias |
| Cantidad maxima de empleados | 5 legajos |
| Funcionalidades | Todas disponibles |

Durante el periodo de prueba, vera un indicador en la barra de estado mostrando los dias restantes.

### Que pasa cuando vence el Trial

Si el periodo de prueba vence o supera los 5 empleados:
1. Se muestra una pantalla de bloqueo
2. El sistema **no permite fichar** hasta que se active una licencia
3. Los datos no se pierden

### Activar una licencia

1. Solicite un **codigo de activacion** a su proveedor
2. Ingrese el codigo en la pantalla de bloqueo o desde el menu **Licencias**
3. El sistema se conecta al servidor de licencias y activa el plan contratado
4. Las limitaciones se levantan segun el plan

### Planes disponibles

| Plan | Legajos | Sucursales | Fichadas/30 dias | Terminales | Digital Face |
|---|---|---|---|---|---|
| **Free** | 5 | 1 | 100 | 1 movil | No |
| **Basic** | 25 | 3 | 300 | 3 | No |
| **Pro** | 50 | 7 | Ilimitadas | 7 | Si |
| **Enterprise** | Ilimitado | Ilimitado | Ilimitadas | Ilimitado | Si |
| **Proyectos Especiales** | A medida | A medida | A medida | A medida | Consultar |

**Notas sobre los planes:**
- El plan **Free** no requiere licencia ni heartbeat. Se activa automaticamente al registrarse en el portal.
- El plan **Proyectos Especiales** contempla integracion con ERP y dispositivos a medida. Contacte a su proveedor para cotizacion.
- Los planes **Pro** y **Enterprise** incluyen el modulo **Digital Face** (reconocimiento facial) sin costo adicional.

### Requisitos de conectividad (planes pagos)

El sistema de licencias requiere conexion a internet periodica:
- Al iniciar la aplicacion (para validar la licencia)
- Cada 4 horas (heartbeat automatico)
- Si pierde conectividad por mas de **72 horas**, el sistema se bloqueara temporalmente hasta recuperar la conexion

---

## 10. PREGUNTAS FRECUENTES

### El Fichador no reconoce el lector de huellas

1. Desconecte y vuelva a conectar el lector USB
2. Espere 10 segundos a que Windows lo reconozca
3. Si persiste, reinicie la aplicacion
4. Si el lector no funciona, puede usar modo PIN como alternativa

### Un empleado olvido fichar

El administrador puede cargar fichadas manuales desde el **Portal Web > Fichadas** o desde **Digital One Administrador > RRHH > Fichadas > Fichada Manual**.

### Se perdio el codigo de activacion

Contacte a su proveedor (Integra IA) para que le regenere un nuevo codigo de activacion.

### El sistema dice "Licencia bloqueada por falta de conexion"

Verifique que el equipo tenga conexion a internet. Una vez restaurada la conexion, reinicie la aplicacion y se desbloqueara automaticamente.

### Puedo instalar Fichador en varias maquinas?

Si. Cada terminal de fichaje necesita su propia instalacion. Todas las terminales pueden apuntar a la misma base de datos.

### Como desinstalo Digital One?

Vaya a **Panel de Control > Programas > Desinstalar un programa**, seleccione **Digital One Suite** y siga las instrucciones. La desinstalacion no elimina la base de datos ni los registros de fichadas.

### Que diferencia hay entre el plan Free y los planes pagos?

El plan Free tiene limites de 5 legajos, 1 sucursal, 100 fichadas por mes y 1 terminal movil. No incluye el modulo Digital Face. Los planes pagos aumentan estos limites y los planes Pro y Enterprise incluyen reconocimiento facial.

### Necesito un FaceAgent por cada sucursal?

No necesariamente. Un FaceAgent puede gestionar multiples terminales siempre que tenga conectividad de red con todas ellas. Lo habitual es instalar uno por red local donde haya terminales faciales.

---

## 11. SOPORTE TECNICO

Ante cualquier inconveniente, contacte al administrador del sistema con la siguiente informacion:

- Mensaje de error exacto (captura de pantalla si es posible)
- Nombre del equipo
- Que estaba haciendo cuando ocurrio el error
- Sistema operativo instalado

**Soporte Integra IA:**
- Sitio web: www.integraia.tech
- Email: notify@integraia.tech

---

*Fin del Manual del Usuario - Digital One v8.0*