feat: cache local de fotos faciais — resolve download em terminais sem suporte

Novo sistema _FaceCache (singleton, face_cache/{employeeNo}.jpg):
- add_face: salva cópia JPEG no cache ao enviar foto ao terminal
- get_face: busca no cache ANTES de qualquer request ISAPI (instantâneo)
- get_face: salva no cache quando download ISAPI tem sucesso
- _export_all_faces: salva todas as fotos exportadas no cache

Cache compartilhado entre terminais pelo employeeNo.
Resolve DS-K1T672MX: foto enviada via qualquer terminal fica disponível.

Bump v4.2.0

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Glauber Varjão

build_info.py

@@ -1 +1 @@
-BUILD_TIMESTAMP = "2026-04-01 19:34"
+BUILD_TIMESTAMP = "2026-04-01 21:22"

core/isapi_client.py

@@ -18,6 +18,57 @@
 from dataclasses import dataclass, field
 from typing import Optional, List, Dict, Any
 
+# === FACE PHOTO CACHE ===
+# Cache local de fotos faciais — salva ao fazer upload, busca quando download falha.
+# Compartilhado entre todos os terminais (indexado por employeeNo).
+class _FaceCache:
+    """Cache local de fotos JPEG indexado por employeeNo."""
+    _instance = None
+
+    def __new__(cls):
+        if cls._instance is None:
+            cls._instance = super().__new__(cls)
+            cls._instance._init_dir()
+        return cls._instance
+
+    def _init_dir(self):
+        import sys as _s
+        if getattr(_s, 'frozen', False):
+            base = os.path.dirname(_s.executable)
+        else:
+            base = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..")
+        self.cache_dir = os.path.join(base, "face_cache")
+        os.makedirs(self.cache_dir, exist_ok=True)
+
+    def save(self, employee_no: str, jpeg_bytes: bytes):
+        """Salva foto no cache."""
+        if not employee_no or not jpeg_bytes or len(jpeg_bytes) < 100:
+            return
+        try:
+            path = os.path.join(self.cache_dir, f"{employee_no}.jpg")
+            with open(path, "wb") as f:
+                f.write(jpeg_bytes)
+        except Exception:
+            pass
+
+    def get(self, employee_no: str):
+        """Retorna bytes JPEG do cache ou None."""
+        try:
+            path = os.path.join(self.cache_dir, f"{employee_no}.jpg")
+            if os.path.isfile(path):
+                with open(path, "rb") as f:
+                    data = f.read()
+                if data and len(data) > 100:
+                    return data
+        except Exception:
+            pass
+        return None
+
+    def exists(self, employee_no: str) -> bool:
+        path = os.path.join(self.cache_dir, f"{employee_no}.jpg")
+        return os.path.isfile(path)
+
+
 # Debug logger para arquivo - compativel com PyInstaller .exe
 _debug_logger = logging.getLogger("isapi_debug")
 _debug_logger.setLevel(logging.DEBUG)
@@ -1695,6 +1746,7 @@ def add_face(self, employee_no, face_data):
         r = self.post("/ISAPI/Intelligent/FDLib/FaceDataRecord", data=body,
                       json_format=True, content_type=f"multipart/form-data; boundary={boundary}")
         if r.get("ok"):
+            _FaceCache().save(employee_no, face_data)
             return r
         # Fallback: FDSetUp (upsert) para modelos que preferem PUT
         _debug_logger.info(f"[add_face] FaceDataRecord falhou ({r.get('error','')}), tentando FDSetUp...")
@@ -1707,13 +1759,22 @@ def add_face(self, employee_no, face_data):
             r2 = self.put("/ISAPI/Intelligent/FDLib/FDSetUp?format=json", data=body2,
                           content_type=f"multipart/form-data; boundary={boundary}")
             if r2.get("ok"):
+                _FaceCache().save(employee_no, face_data)
                 return r2
         except Exception:
             pass
         return r  # Retornar erro original
 
     def get_face(self, employee_no, log_callback=None):
-        """Busca imagem facial de um funcionario. Retorna bytes da imagem ou None.
+        """Busca imagem facial. Verifica cache local primeiro, depois ISAPI.
+        Salva no cache automaticamente quando encontra."""
+        result = self._get_face_impl(employee_no, log_callback)
+        if result and len(result) > 100:
+            _FaceCache().save(employee_no, result)
+        return result
+
+    def _get_face_impl(self, employee_no, log_callback=None):
+        """Implementação interna do get_face — busca via ISAPI com múltiplas fases.
         Descobre automaticamente o tipo de biblioteca facial do terminal.
         log_callback(msg) — se fornecido, envia mensagens de progresso para a UI."""
         from urllib.parse import urlparse
@@ -1763,6 +1824,12 @@ def _safe_get(endpoint):
             except Exception as e:
                 return {"ok": False, "error": str(e), "status_code": 0}
 
+        # === CACHE LOCAL: busca instantânea antes de qualquer request ===
+        cached = _FaceCache().get(employee_no)
+        if cached:
+            _log(f"Cache hit! {len(cached)//1024}KB")
+            return cached
+
         # Aquecer sessão Digest Auth
         _log("Autenticando sessão...")
         try:
@@ -2558,6 +2625,10 @@ def _src_wait_ready():
 
         log(f"Export concluido: {ok_count} baixadas, {fail_count} falhas "
             f"de {len(face_records)} registros")
+        # Salvar todas as fotos exportadas no cache local
+        cache = _FaceCache()
+        for emp_no, jpeg in faces.items():
+            cache.save(emp_no, jpeg)
         return faces
 
     def delete_faces(self, employee_nos: list, callback=None) -> Dict[str, Any]:

file_version_info.txt

@@ -1,8 +1,8 @@
 # UTF-8
 VSVersionInfo(
   ffi=FixedFileInfo(
-    filevers=(4, 1, 9, 0),
-    prodvers=(4, 1, 9, 0),
+    filevers=(4, 2, 0, 0),
+    prodvers=(4, 2, 0, 0),
     mask=0x3f,
     flags=0x0,
     OS=0x40004,
@@ -18,12 +18,12 @@ VSVersionInfo(
           [
             StringStruct(u'CompanyName', u'Protector Sistemas'),
             StringStruct(u'FileDescription', u'Protector ISAPI Manager'),
-            StringStruct(u'FileVersion', u'4.1.9'),
+            StringStruct(u'FileVersion', u'4.2.0'),
             StringStruct(u'InternalName', u'Protector_ISAPI_Manager'),
             StringStruct(u'LegalCopyright', u'© 2026 Protector Sistemas'),
             StringStruct(u'OriginalFilename', u'Protector_ISAPI_Manager.exe'),
             StringStruct(u'ProductName', u'Protector ISAPI Manager'),
-            StringStruct(u'ProductVersion', u'4.1.9'),
+            StringStruct(u'ProductVersion', u'4.2.0'),
           ]
         )
       ]

installer.iss

@@ -14,7 +14,7 @@
 ; ============================================================================
 
 #define MyAppName "Protector ISAPI Manager"
-#define MyAppVersion "4.1.9"
+#define MyAppVersion "4.2.0"
 #define MyAppPublisher "Protector Sistemas"
 #define MyAppURL "https://github.com/ProtectorAnalytics/protector-isapi-manager"
 #define MyAppExeName "Protector_ISAPI_Manager.exe"

version.py

@@ -10,7 +10,7 @@
 # MAJOR = mudança que quebra compatibilidade
 # MINOR = funcionalidades novas (retrocompatíveis)
 # PATCH = correções de bugs
-VERSION = "4.1.9"
+VERSION = "4.2.0"
 
 # Status: "stable", "beta", "dev", "rc1", "rc2"...
 VERSION_STATUS = "stable"