08 — Versiones y releases (historial v0.1.0 → v0.3.1)

Registro de versiones del sistema de asistencia, con los cambios funcionales, técnicos y los artefactos publicados en cada release.

1. Resumen de versiones

Versión actual: 0.3.1+6 (mobile/pubspec.yaml).

2. Detalle por versión

v0.1.0 — MVP (2026-09-15)

Primera versión funcional desplegada en producción.

• Móvil: login JWT (AuthGate → LoginScreen → HomeScreen), check-in/out con GPS, anti-spoofing en dos capas (detección mock/root/jailbreak), geocercas PostGIS, autoridad de tiempo NTP en el servidor.
• Backend: FastAPI + SQLAlchemy 2 + asyncpg; eventos append-only con cadena de hash HMAC-SHA256 (tamper-evidence); cifrado de PII (AES-256-GCM).
• DB: db/000_schema.sql + 001_immutability.sql (triggers) + 002_seed.sql (10 empleados ficticios, 3 sitios: CDMX / Monterrey / GDL).
• Infra: Linode (systemd ia-asistencia.service, uvicorn :8095, PostGIS Docker :5433, nginx).
• APK: com.intt2hub.asistencia_geo, minSdk efectivo 24.

v0.2.0 — Historial + biométrico (2026-09-17)

• Nueva pantalla HistoryScreen (consume GET /attendance/me).
• Check-in sin botón: local_auth automático al abrir (huella/rostro), deduce Entrada/Salida según sesión abierta; fallback a botón si no hay biometría.
• Corrección: subí version de 0.1.0+1 a 0.2.0+2 (versionCode correcto).

v0.2.1 — Fix biometría + token (2026-09-17)

• Fix biometría: MainActivity.kt pasa de FlutterActivity a FlutterFragmentActivity (requisito de local_auth en Android).
• Fix token: AuthService.refresh() + auto-refresh en 401 (ApiClient.onUnauthorized).

v0.2.2 — Fix cuelgue en arranque (2026-09-17)

• Causa raíz: flutter_secure_storage corrupto tras reinstalar (BadPaddingException) → AuthGate._check() sin try/catch dejaba _loading=true para siempre.
• Fix: SecureStorage resiliente (timeout(8s) + deleteAll + null → login) y try/catch defensivo en AuthGate.

v0.3.0 — Entrada/Salida + logo INT + aprobación (2026-09-18)

• Móvil: botones “Registrar Entrada” (verde) / “Registrar Salida” (naranja) ANTES del biométrico; logo INT; tema naranja #E08010.
• Backend (parcial): preparación del workflow de aprobación (modelos ProfileType.site/remote, EmployeeSiteAssignment.valid_from/valid_until).

v0.3.1 — Aprobaciones + panel admin (2026-09-18)

• Backend: tabla mutable attendance_approvals (enum pending/approved/rejected); el check-in fuera de zona/horario ya no bloquea, se guarda como pending con motivo; services/geofence.py devuelve (GeofenceStatus, site_id) sin lanzar.
• Endpoints admin (/admin): assignments CRUD, approvals (list/approve/reject con audit log), sites CRUD, employees PATCH.
• Panel admin React (login JWT, tabs Zonas/Empleados/Asignaciones/Aprobaciones), servido desde FastAPI en /panel.
• Móvil: badge naranja “Pendiente de autorización” en historial.

v0.3.1 (registro) — Registro autoservicio (2026-09-21)

• Backend: POST /auth/register (201): crea User employee/remote, Argon2id, email único (409), auto-login.
• Panel + móvil: toggle login/registro (nombre completo, correo, contraseña).
• Publicado como INT_Asistencia_v0.3.1.apk (sin bump de versión; misma 0.3.1).

Plan Odoo (2026-09-22) — solo plan

Ver PLAN_INTEGRACION_ODOO.md y docs/05-odoo-integration.md. El pipeline “salida” (Asistencia → hr.attendance) ya está codificado (outbox odoo_sync + odoo_client.py); falta schema de producción, custom fields x_*, usuario API y activar el scheduler.

3. Artefactos publicados (APK)

Los APK se publican en https://www.intt2hub.com/ia/downloads/asistencia/<fecha>_vNNN/ y el symlink latest apunta al más reciente. El checksum completo está en entregas/asistencia-geo/SHA256SUMS.txt.