Fichaje

README

📱 Sistema de Fichaje con NFC

Aplicación web para gestionar entrada, salida y descansos de empleados usando integración con chips NFC.

✨ Características

✅ Integración NFC: Lee chips NFC automáticamente (Android Chrome)
✅ Captura automática de hora: La hora se toma del móvil del empleado
✅ Lista de empleados: Selección mediante dropdown desplegable
✅ 4 tipos de registro: Entrada, Salida, Inicio Descanso, Fin Descanso
✅ Reportes por empleado: Visualización en pestañas por persona
✅ Exportación a Excel: Crea archivos .xlsx con pestañas por empleado
✅ PWA Instalable: Funciona como app nativa en móvil
✅ Soporte offline: Funciona sin conexión a internet
✅ Almacenamiento local: Los datos se guardan en el móvil

🚀 Instalación

Opción 1: Servidor Local (Desarrollo)

# Navega al directorio
cd /Users/corandjilali/Documents/FICHAJE

# Inicia un servidor local (Python 3)
python3 -m http.server 8000

# O con Node.js (si tienes http-server instalado)
npx http-server

Accede a: http://localhost:8000

Opción 2: Servidor en Línea

Sube los archivos a un servidor web (Vercel, Netlify, etc.). Importante: Usa HTTPS (obligatorio para NFC y PWA).

📲 Cómo Usar

Página de Fichaje (`index.html`)

Abre la app en tu móvil (Chrome Android recomendado)
Instala como app (opción "Agregar a pantalla de inicio")
Selecciona tu nombre del dropdown
Toca el chip NFC con tu móvil (se detectará automáticamente)
- O presiona el botón correspondiente (Entrada, Salida, etc.)
Confirma el registro en la notificación
Tu última acción aparecerá en la parte inferior

Página de Reportes (`admin.html`)

Presiona el botón "📊 Ver Reportes"
Selecciona pestañas para ver datos por empleado
Opciones disponibles:
- 📥 Exportar a Excel: Descarga archivo con pestañas por empleado
- 🗑️ Limpiar datos: Borra todos los registros
- ← Volver a Fichaje: Regresa a la página principal

🏷️ Configuración del Chip NFC

Programación del Chip

Usa una app como NFC Tools (Android/iOS) o Tagwriter by NXP:

Abre la app NFC
Nuevo registro → URL/URI
Escribe esta URL:
```
https://tu-dominio.com/index.html
```
(Cambia tu-dominio.com por tu servidor real)
Escribe el chip
Prueba: Toca el chip, debe abrir tu app

URL Alternativa con Parámetros

Para diferenciar chips por tipo:

https://tu-dominio.com/index.html?nfc=entrada

📊 Exportación a Excel

El archivo descargado tiene esta estructura:

Archivos generados: Fichaje_YYYY-MM-DD.xlsx

Contenido:

Hoja "Resumen":
- Empleado, Total Registros, Último Registro
Hojas individuales (una por empleado):
- Fecha | Hora | Tipo
- Ejemplo: 2026-04-26 | 09:15:32 | Entrada

💾 Almacenamiento de Datos

Los datos se guardan en localStorage del navegador:

Sin servidores backend
Sin internet requerido (después de la primera carga)
Privado al dispositivo

Ubicación de datos:

ChromeOS: /Users/corandjilali/AppData/Local/Google/Chrome/...
Android: Datos de la app (internos)

Estructura almacenada:

{
  "fichajes_data": [
    {
      "id": 1714120532123.456,
      "empleado": "Juan García",
      "tipo": "entrada",
      "fecha": "2026-04-26",
      "hora": "09:15:32",
      "timestamp": 1714120532123
    }
  ]
}

👥 Agregar/Modificar Empleados

Opción 1: Desde la app

(Característica futura - actualmente viene preconfigurada)

Opción 2: Editar localStorage manualmente

Abre la consola del navegador (F12):

// Ver empleados actuales
JSON.parse(localStorage.getItem('empleados_list'))

// Agregar nuevo empleado
let empleados = JSON.parse(localStorage.getItem('empleados_list')) || [
  'Juan García',
  'María López',
  'Carlos Martínez'
];
empleados.push('Nuevo Empleado');
localStorage.setItem('empleados_list', JSON.stringify(empleados));

🔧 Requisitos Técnicos

Para NFC:

📱 Android 4.4+ con NFC
🌐 Chrome, Edge, Opera (Navegadores Chromium)
🔒 HTTPS obligatorio (en servidor)
⚠️ iOS limitado: Solo iOS 13.6+ con aplicación nativa

Para PWA (instalación):

🌐 Navegador moderno (Chrome, Edge, Firefox)
🔒 HTTPS (en servidor)
📱 144x144px icono mínimo (incluido)

🚨 Solución de Problemas

"NFC no disponible"

✓ Usa Android con Chrome
✓ Activa NFC en Ajustes del teléfono
✓ Usa botones como alternativa

"No puedo instalar como app"

✓ Usa Chrome en Android
✓ Necesita HTTPS
✓ Espera 30 segundos, aparecerá opción

"Los datos desaparecen"

✓ No limpies datos de la app
✓ No uses "Borrar datos del navegador"
✓ Exporta periódicamente a Excel

"El chip NFC no abre la app"

✓ Verifica la URL en el chip (con NFC Tools)
✓ Usa HTTPS en la URL
✓ Escribe bien el dominio

📁 Estructura de Archivos

FICHAJE/
├── index.html          # Página de fichaje
├── admin.html          # Reportes y exportación
├── manifest.json       # Configuración PWA
├── sw.js              # Service Worker (offline)
└── README.md          # Este archivo

🔐 Privacidad y Seguridad

✅ Sin servidor central: Los datos quedan en el móvil
✅ Sin envío de datos: Todo local
✅ HTTPS recomendado: Protege en tránsito
✅ Respaldo manual: Exporta periódicamente a Excel

📝 Versión

v1.0 - Abril 2026

💡 Características Futuras

¿Preguntas o problemas? Revisa la consola del navegador (F12) para mensajes de error.