fix: logging detalhado Fase 3/4 + fix indentação + mensagem clara por modelo

Testado em terminais reais:
- DS-K1T671MF (V3.2.30): LOCALS/ funciona via HTTP (200 + JPEG)
- DS-K1T672MX (V3.18.0): isSupportFDSearchDataPackage=false, sem download remoto

Fase 3 agora loga Content-Type, tamanho e primeiros bytes de cada tentativa.
Mensagem final indica limitação do firmware quando não suporta download.
Bump v4.1.8

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:08"
+BUILD_TIMESTAMP = "2026-04-01 19:28"

core/isapi_client.py

@@ -1899,11 +1899,39 @@ def _safe_get(endpoint):
                 break
 
         # === FASE 3: FDSearch multipart FILTRADO por employeeNo ===
-        # Sem ?format=json, o terminal retorna o JPEG embutido no multipart
+        # Sem ?format=json, terminal retorna JPEG embutido no multipart boundary
         _log("Tentativa 3: FDSearch multipart filtrado por employeeNo")
+
+        def _try_multipart_search(endpoint, payload_str, label):
+            """Faz POST e tenta extrair JPEG do multipart. Retorna img ou None."""
+            try:
+                url = self._url(endpoint)
+                resp = self.session.post(url, data=payload_str.encode("utf-8"),
+                                         headers={"Content-Type": "application/json"},
+                                         timeout=face_timeout)
+                status = resp.status_code
+                data = resp.content
+                data_len = len(data) if data else 0
+                ct = resp.headers.get("Content-Type", "")
+                _log(f"  → {label}: status={status} size={data_len}B ct={ct[:60]}")
+                if status == 200 and data and data_len > 500:
+                    img = _extract_jpeg(data)
+                    if img and len(img) > 1024:
+                        _log(f"  → JPEG encontrado! {len(img)//1024}KB")
+                        return img
+                    # Se não tem JPEG, mostrar amostra dos dados para debug
+                    if data_len > 100:
+                        sample = data[:80]
+                        _log(f"  → Sem JPEG. Primeiros bytes: {sample[:40]}")
+                return None
+            except Exception as e:
+                _log(f"  → {label}: erro={e}")
+                return None
+
         for fdid, fd_type in fd_configs:
-            # 3a: Busca com filtro faceCustomCondition (terminais mais novos)
-            for search_payload in [
+            # 3a: FDSearch multipart com filtro byEmployeeNo
+            img = _try_multipart_search(
+                "/ISAPI/Intelligent/FDLib/FDSearch",
                 json.dumps({
                     "faceLibType": fd_type, "FDID": fdid,
                     "searchResultPosition": 0, "maxResults": 1,
@@ -1912,92 +1940,85 @@ def _safe_get(endpoint):
                         "EmployeeNoList": [{"employeeNo": employee_no}]
                     }
                 }),
-                # 3b: Busca com FPID direto (terminais mais antigos)
+                f"3a byEmployeeNo ({fd_type})")
+            if img:
+                return img
+
+            # 3b: FDSearch multipart com FPID direto
+            img = _try_multipart_search(
+                "/ISAPI/Intelligent/FDLib/FDSearch",
                 json.dumps({
                     "faceLibType": fd_type, "FDID": fdid, "FPID": employee_no,
                     "searchResultPosition": 0, "maxResults": 1
                 }),
-            ]:
-                resp = _safe_post("/ISAPI/Intelligent/FDLib/FDSearch", search_payload)
-                status = resp.get("status_code", 0)
-                data = resp.get("data", b"")
-                data_len = len(data) if isinstance(data, bytes) else 0
-                if status == 200 and data_len > 500:
-                    _log(f"  → Multipart data: {data_len} bytes")
-                    img = _extract_jpeg(data)
-                    if img and len(img) > 1024:
-                        _log(f"  → JPEG encontrado! {len(img)//1024}KB")
-                        return img
-                    _log(f"  → Sem JPEG no multipart (data tem {data_len}B)")
-                elif status == 400:
-                    continue  # tipo errado, tentar próximo
-                elif status != 200:
-                    _log(f"  → status={status}")
+                f"3b FPID direto ({fd_type})")
+            if img:
+                return img
 
-            # 3c: Busca pela página que contém o registro (fallback amplo)
+            # 3c: FDSearch multipart SEM faceLibType (alguns terminais ignoram)
+            img = _try_multipart_search(
+                "/ISAPI/Intelligent/FDLib/FDSearch",
+                json.dumps({
+                    "FDID": fdid,
+                    "searchResultPosition": 0, "maxResults": 1,
+                    "faceCustomCondition": {
+                        "searchType": "byEmployeeNo",
+                        "EmployeeNoList": [{"employeeNo": employee_no}]
+                    }
+                }),
+                f"3c sem faceLibType")
+            if img:
+                return img
+
+            # 3d: Busca pela página completa (extrai todos JPEGs)
             if found_match:
                 page_start = max(0, pos - 30)
-                payload = json.dumps({
-                    "faceLibType": fd_type, "FDID": fdid,
-                    "searchResultPosition": page_start, "maxResults": 30
-                })
-                resp = _safe_post("/ISAPI/Intelligent/FDLib/FDSearch", payload)
-                if resp.get("ok") and resp.get("data"):
-                    data = resp["data"]
-                    if len(data) > 2000:
-                        _log(f"  → Página multipart: {len(data)} bytes")
-                        idx = 0
-                        jpeg_list = []
-                        while True:
-                            start = data.find(b'\xff\xd8\xff', idx)
-                            if start < 0:
-                                break
-                            end = data.find(b'\xff\xd9', start + 3)
-                            if end < 0:
-                                break
-                            jpeg_list.append(data[start:end + 2])
-                            idx = end + 2
-                        if jpeg_list:
-                            _log(f"  → {len(jpeg_list)} JPEG(s) na página")
-                            for jpg in jpeg_list:
-                                if len(jpg) > 1024:
-                                    _log(f"  → Retornando JPEG {len(jpg)//1024}KB")
-                                    return jpg
-
-        # === FASE 4: FaceDataRecord + endpoints diretos GET ===
-        _log("Tentativa 4: FaceDataRecord + GET endpoints diretos")
-        for fdid, fd_type in fd_configs:
-            # 4a: FaceDataRecord (alguns terminais suportam GET por FPID)
-            fdr_payload = json.dumps({
-                "faceLibType": fd_type, "FDID": fdid, "FPID": employee_no
-            })
-            resp = _safe_post("/ISAPI/Intelligent/FDLib/FaceDataRecord?format=json", fdr_payload)
-            if resp.get("ok") and resp.get("data"):
-                img = _extract_jpeg(resp["data"])
-                if img and len(img) > 100:
-                    _log(f"  → JPEG via FaceDataRecord! {len(img)//1024}KB")
+                img = _try_multipart_search(
+                    "/ISAPI/Intelligent/FDLib/FDSearch",
+                    json.dumps({
+                        "faceLibType": fd_type, "FDID": fdid,
+                        "searchResultPosition": page_start, "maxResults": 30
+                    }),
+                    f"3d página {page_start}-{page_start+30}")
+                if img:
                     return img
 
-            # 4b: Endpoints diretos GET
-            for ep in [
-                f"/ISAPI/Intelligent/FDLib/{fdid}/picture/{employee_no}?faceLibType={fd_type}",
-                f"/ISAPI/Intelligent/FDLib/{fdid}/picture/{employee_no}",
-                f"/ISAPI/AccessControl/UserInfo/UserPic/{employee_no}",
-                f"/ISAPI/Intelligent/FDLib/FDDownload?format=json&FDID={fdid}&FPID={employee_no}",
-                f"/ISAPI/AccessControl/CaptureFaceData",
-            ]:
-                resp = _safe_get(ep)
-                status = resp.get("status_code", 0)
-                if resp.get("ok") and resp.get("data"):
-                    img = _extract_jpeg(resp["data"])
-                    if img and len(img) > 100:
-                        _log(f"  → JPEG via GET! {len(img)//1024}KB")
-                        return img
-                if status != 404:
-                    _log(f"  → {ep.split('/')[-1][:40]}: status={status}")
+        # === FASE 4: Endpoints alternativos ===
+        _log("Tentativa 4: Endpoints alternativos")
+        for fdid, fd_type in fd_configs:
+            endpoints = [
+                ("POST", f"/ISAPI/Intelligent/FDLib/FaceDataRecord?format=json",
+                 json.dumps({"faceLibType": fd_type, "FDID": fdid, "FPID": employee_no})),
+                ("GET", f"/ISAPI/Intelligent/FDLib/{fdid}/picture/{employee_no}?faceLibType={fd_type}", None),
+                ("GET", f"/ISAPI/Intelligent/FDLib/{fdid}/picture/{employee_no}", None),
+                ("GET", f"/ISAPI/AccessControl/UserInfo/UserPic/{employee_no}", None),
+                ("GET", f"/ISAPI/Intelligent/FDLib/FDDownload?format=json&FDID={fdid}&FPID={employee_no}", None),
+            ]
+            for method, ep, payload in endpoints:
+                try:
+                    url = self._url(ep)
+                    if method == "POST" and payload:
+                        r = self.session.post(url, data=payload,
+                                              headers={"Content-Type": "application/json"},
+                                              timeout=face_timeout)
+                    else:
+                        r = self.session.get(url, timeout=face_timeout)
+                    status = r.status_code
+                    data_len = len(r.content) if r.content else 0
+                    ep_short = ep.split("?")[0].split("/")[-1]
+                    if status == 200 and r.content:
+                        img = _extract_jpeg(r.content)
+                        if img and len(img) > 100:
+                            _log(f"  → JPEG via {method} {ep_short}! {len(img)//1024}KB")
+                            return img
+                    if status not in (404, 403):
+                        _log(f"  → {method} {ep_short}: status={status} size={data_len}B")
+                except Exception as e:
+                    _log(f"  → {method} {ep.split('/')[-1][:30]}: erro={e}")
 
-        _log("Foto não acessível via ISAPI — este terminal não expõe fotos por HTTP. "
-             "A foto está no armazenamento interno (LOCALS/) mas não é baixável remotamente.")
+        _log("Todas as tentativas falharam. Este terminal (firmware) não suporta "
+             "download remoto de fotos faciais via ISAPI. A foto existe no armazenamento "
+             "interno (LOCALS/) mas isSupportFDSearchDataPackage=false.")
         return None
 
     def delete_face(self, employee_no):

file_version_info.txt

@@ -1,8 +1,8 @@
 # UTF-8
 VSVersionInfo(
   ffi=FixedFileInfo(
-    filevers=(4, 1, 7, 0),
-    prodvers=(4, 1, 7, 0),
+    filevers=(4, 1, 8, 0),
+    prodvers=(4, 1, 8, 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.7'),
+            StringStruct(u'FileVersion', u'4.1.8'),
             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.7'),
+            StringStruct(u'ProductVersion', u'4.1.8'),
           ]
         )
       ]

installer.iss

@@ -14,7 +14,7 @@
 ; ============================================================================
 
 #define MyAppName "Protector ISAPI Manager"
-#define MyAppVersion "4.1.7"
+#define MyAppVersion "4.1.8"
 #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.7"
+VERSION = "4.1.8"
 
 # Status: "stable", "beta", "dev", "rc1", "rc2"...
 VERSION_STATUS = "stable"