pyflutter-app 0.3.10__tar.gz → 0.3.12__tar.gz

{pyflutter_app-0.3.10 → pyflutter_app-0.3.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pyflutter_app
-Version: 0.3.10
+Version: 0.3.12
 Summary: Bibliotecas Python para conversão de documentos, interface e processamento de tabelas.
 Requires-Python: >=3.12
 Requires-Dist: opencv-python>=5.0.0.93

{pyflutter_app-0.3.10 → pyflutter_app-0.3.12}/cartas/__init__.py

@@ -51,7 +51,7 @@ __version__ = "0.2"
 class ConfigTOI:
 
     file_relatorio_toi: File
-    file_relatorio_forms: File
+    file_cartas_lancadas: File
     file_table_toi: File
     file_master_forms: File  # NOVO
     dir_base_toi: Directory
@@ -126,7 +126,7 @@ class BuilderConfigTOI(object):
             dir_base_toi=self.dir_retorno_de_campo,
             file_relatorio_toi=self.file_relatorio_toi,
             file_table_toi=self.file_table_toi,
-            file_relatorio_forms=self.file_relatorio_forms,
+            file_cartas_lancadas=self.file_relatorio_forms,
             dir_log_excel=self.dir_log_excel,
             dir_relatorios=self.dir_relatorios,
             file_master_forms=self.file_master_forms,

pyflutter_app-0.3.10/converter/home_page/view.py → pyflutter_app-0.3.12/converter/home_page/page_sheets.py

@@ -1,8 +1,6 @@
 from pyflutter_ui import (
-    ChangeNotifier,
     BuildContext,
     FlutterWidget,
-    LinearProgress,
     StatelessWidget,
     Consumer,
     Column,
@@ -23,10 +21,7 @@ from pyflutter_ui import (
 )
 
 from tkinter import messagebox
-from typing import Any
 import pandas as pd
-from pandas import DataFrame
-
 
 from table_stream import (
     ArrayList,
@@ -40,25 +35,20 @@ from table_stream import (
 from converter.home_page.controller import ControllerHomePage
 from converter.table_widget import TableOrProgress
 from converter.home_page._page_edit import PageEditExcel
-
-# Páginas para navegação.
-from converter.page_forms import PageRespondsForms
-from converter.page_forms import ControllerForms
-from converter.config_app import MapConfig, AppConfigNotifier
-from converter.page_image import PageImage
-from converter.page_circuit import PageCircuit
+from converter.config_app import AppConfigNotifier
 
 
-class HomePage(StatelessWidget):
+class PageSheets(StatelessWidget):
+    """Importar/carregar planilhas. De lá se acessa a edição de dados."""
 
     def __init__(self, key: str | None = None) -> None:
         super().__init__(key)
 
     def build(self, context: BuildContext) -> FlutterWidget:
-        return _HomePageState()
+        return _PageSheetsState()
 
 
-class _HomePageState(StatelessWidget):
+class _PageSheetsState(StatelessWidget):
 
     def __init__(self, key: str | None = None) -> None:
         super().__init__(key)
@@ -95,8 +85,7 @@ class _HomePageState(StatelessWidget):
 
     @property
     def app_config(self) -> AppConfigNotifier:
-        state = Provider.read(AppConfigNotifier)
-        return state
+        return Provider.read(AppConfigNotifier)
 
     @property
     def controller(self) -> ControllerHomePage:
@@ -232,29 +221,11 @@ class _HomePageState(StatelessWidget):
             df=data.head(),
         )
 
-    def action_open_forms(self, context: BuildContext, controller: ControllerHomePage):
-        """
-            Seta o DataFrame() da página atual como propriedade do ControllerForms()
-        antes de carregar a página.
-        """
-        # df = controller.data_notifier.value
-        # forms_controller: ControllerForms = context.read(ControllerForms)
-        # forms_controller.set_data(df)
-        # if not forms_controller.forms_state.data_is_valid():
-        #    messagebox.showerror("Erro", "Tabela TOI inválida")
-        #    return
-
-        context.navigator.push(PageRespondsForms())
-
     def _builder_body(
         self, context: BuildContext, controller: ControllerHomePage
     ) -> FlutterWidget:
         self.context = context
 
-        filename = controller.get_file_sheet()
-        if filename is not None:
-            filename = filename.basename()
-
         return Column(
             children=[
                 # -----------------------------------#
@@ -315,24 +286,14 @@ class _HomePageState(StatelessWidget):
                 Expanded(Consumer(ControllerHomePage, self._build_table)),
                 Row(
                     [
+                        ElevatedButton(
+                            "<- Voltar", lambda: context.navigator.pop()
+                        ),
                         Text("Ir para: "),
                         ElevatedButton(
                             "Edição de dados",
                             lambda: context.navigator.push(PageEditExcel()),
                         ),
-                        # ElevatedButton("Exportar dados", lambda: print()),
-                        ElevatedButton(
-                            "Responds Forms",
-                            lambda: self.action_open_forms(context, controller),
-                        ),
-                        ElevatedButton(
-                            "Renomear imagens",
-                            lambda: context.navigator.push(PageImage()),
-                        ),
-                        ElevatedButton(
-                            "Dividir base (QGIS)",
-                            lambda: context.navigator.push(PageCircuit()),
-                        ),
                     ],
                     main_axis_alignment=MainAxisAlignment.START,
                 ),

pyflutter_app-0.3.12/converter/home_page/view.py

@@ -0,0 +1,71 @@
+from typing import Callable
+
+from pyflutter_ui import (
+    BuildContext,
+    FlutterWidget,
+    StatelessWidget,
+    Column,
+    Row,
+    ElevatedButton,
+    Divider,
+    MainAxisAlignment,
+    Scaffold,
+    Text,
+)
+
+# Páginas para navegação.
+from converter.home_page.page_sheets import PageSheets
+from converter.page_forms import PageRespondsForms
+from converter.page_image import PageImage
+from converter.page_circuit import PageCircuit
+from converter.page_whatsapp import PageWhatsApp
+from converter.page_ocr import PageOcr
+from pyflutter_ui.ui.core import GlobalKey
+
+
+class HomePage(StatelessWidget):
+    """Home: somente botões para navegar entre as páginas."""
+
+    def __init__(self, key: GlobalKey | None = None) -> None:
+        super().__init__(key)
+
+    def build(self, context: BuildContext) -> FlutterWidget:
+        return _HomePageState()
+
+
+class _HomePageState(StatelessWidget):
+
+    # (rótulo do botão, descrição, página)
+    PAGES: list[tuple[str, str, Callable[[], FlutterWidget]]] = [
+        ("Planilhas", "Importar/carregar planilhas e editar dados", PageSheets),
+        ("WhatsApp", "Importar chats (.zip) para o cache do WhatsApp", PageWhatsApp),
+        ("Responds Forms", "Lançar cartas TOI no Microsoft Forms", PageRespondsForms),
+        ("Renomear imagens", "Identificar cartas (UC / TOI / data)", PageImage),
+        ("Dividir base (QGIS)", "Dividir a base por coluna (CSV/Excel)", PageCircuit),
+        ("OCR", "Aplicar OCR em PDFs e imagens de uma pasta", PageOcr),
+    ]
+
+    def __init__(self, key: GlobalKey | None = None) -> None:
+        super().__init__(key)
+
+    def _nav_item(
+        self,
+        context: BuildContext,
+        label: str,
+        description: str,
+        page: Callable[[], FlutterWidget],
+    ) -> FlutterWidget:
+        return Row(
+            [
+                ElevatedButton(label, lambda: context.navigator.push(page())),
+                Text(description),
+            ],
+            main_axis_alignment=MainAxisAlignment.START,
+        )
+
+    def build(self, context: BuildContext) -> FlutterWidget:
+        items = [
+            self._nav_item(context, label, desc, page)
+            for label, desc, page in self.PAGES
+        ]
+        return Scaffold(Column([Text("App Convert"), Divider(), *items]))

{pyflutter_app-0.3.10 → pyflutter_app-0.3.12}/converter/page_forms/controller_forms.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 import os
 from datetime import datetime
 from typing import Callable
+import threading
 
 import pandas as pd
 
@@ -47,6 +48,8 @@ class ControllerForms(ChangeNotifier):
         self.master = ControllerMasterForms()
         self.generating: bool = False
 
+        self.scanning: bool = False  # NOVO: lendo a pasta
+
         # Log em Excel gravado durante o lançamento (1 arquivo por execução).
         self.save_every: int = 2  # grava a cada N linhas concluídas (sucesso OU falha)
         self.result_file: File | None = None
@@ -123,9 +126,10 @@ class ControllerForms(ChangeNotifier):
 
     # ------------------------------------------------------------------ gerar tabela (cache)
     def generate_table(self, files: ArrayList[File]) -> None:
-        if self.running or self.generating:
+        if self.running or self.generating or self.scanning:
             self.show_info("Existe outra operação em andamento.")
             return
+
         if files.empty():
             return
 
@@ -146,6 +150,54 @@ class ControllerForms(ChangeNotifier):
             self.generating = False
             self.show_error(str(e))
 
+    def generate_table_from_folder(self, folder: Directory) -> None:
+        """Varre a pasta (recursivo, PDF/imagem) e gera a tabela só com o cache."""
+        if self.running or self.generating or self.scanning:
+            self.show_info("Existe outra operação em andamento.")
+            return
+        if not folder.exists():
+            self.show_error(f"A pasta não existe:\n{folder.absolute()}")
+            return
+
+        self.scanning = True
+        self.status_text = f"Lendo {folder.absolute()} (incluindo subpastas) ..."
+        self.notify_listeners()
+
+        def work() -> None:
+            files: ArrayList[File] | None = None
+            err: Exception | None = None
+            try:
+                files = self.model.list_documents(folder)
+            except Exception as e:
+                err = e
+            _ui(lambda: self._on_folder_scanned(folder, files, err))
+
+        threading.Thread(target=work, daemon=True, name="forms-scan").start()
+
+    def _on_folder_scanned(
+        self,
+        folder: Directory,
+        files: ArrayList[File] | None,
+        err: Exception | None,
+    ) -> None:
+        self.scanning = False
+
+        if err is not None or files is None:
+            self.status_text = f"Erro ao ler a pasta: {err}"
+            self.notify_listeners()
+            self.show_error(f"Não foi possível ler a pasta:\n{err}")
+            return
+
+        if files.empty():
+            self.status_text = "Nenhum PDF/imagem encontrado na pasta."
+            self.notify_listeners()
+            self.show_info(f"Nenhum PDF ou imagem encontrado em:\n{folder.absolute()}")
+            return
+
+        self.status_text = f"{files.size()} arquivo(s) encontrados. Gerando tabela ..."
+        self.notify_listeners()
+        self.generate_table(files)  # fluxo existente (hash + cache + Excel)
+
     def _on_gen_progress(self, done: int, total: int) -> None:
         self.progress = (done, total)
         self.status_text = f"Calculando hashes {done}/{total}"
@@ -235,10 +287,10 @@ class ControllerForms(ChangeNotifier):
 
     # ------------------------------------------------------------------ execução
     def start_forms(self) -> None:
-
-        if self.running or self.generating:
+        if self.running or self.generating or self.scanning:
             self.show_info("Já existe uma operação em andamento.")
             return
+
         if self.map_rows.is_empty():
             self.show_error("Importe uma tabela TOI antes de iniciar.")
             return

{pyflutter_app-0.3.10 → pyflutter_app-0.3.12}/converter/page_forms/model_forms.py

@@ -15,6 +15,8 @@ from table_stream import (
     HashMapDict,
     RowH,
     TableData,
+    ContentFiles,
+    EnumDocuments,
     load_file_hash,
 )
 from cartas import (
@@ -250,6 +252,19 @@ class ModelForms(object):
         t = getattr(self, "_gen_thread", None)
         return t is not None and t.is_alive()
 
+    @staticmethod
+    def list_documents(folder: Directory, max_files: int = 200_000) -> ArrayList[File]:
+        """PDFs e imagens da pasta, lendo as subpastas (extensão sem diferenciar maiúsculas)."""
+        content = ContentFiles(folder, max_files=max_files)
+        everything = content.get_files(EnumDocuments.ALL, sort=True, recursive=True)
+
+        valid = ArrayList[File]()
+        for f in everything:
+            ext = (f.extension() or "").lower()
+            if ext == ".pdf" or ext in (".png", ".jpg", ".jpeg"):
+                valid.add(f)
+        return valid
+
     def generate_table(
         self,
         files: ArrayList[File],

{pyflutter_app-0.3.10 → pyflutter_app-0.3.12}/converter/page_forms/view_forms.py

@@ -43,11 +43,8 @@ class _PageRespondsFormsState(StatelessWidget):
     def __init__(self, key=None):
         super().__init__(key)
 
-        self.file_picker_cartas = FilePickerController(
-            type=FilePickerType.custom,
-            allow_multiple=True,
-            allowed_extensions=["pdf", "png", "jpg", "jpeg"],
-            dialog_title="Escolha as cartas (PDF/imagem)",
+        self.picker_cartas_dir = FilePickerController(
+            dialog_title="Escolha a pasta com as cartas (PDF/imagem)",
         )
 
         self.file_picker = FilePickerController(
@@ -70,21 +67,21 @@ class _PageRespondsFormsState(StatelessWidget):
 
     # ------------------------------------------------------------------ ações
     def action_generate_table(self, controller: ControllerForms) -> None:
-        if controller.running or controller.generating:
+        if controller.running or controller.generating or controller.scanning:
             self.show_info("Existe outra operação em andamento.")
             return
 
         conf = controller.get_config()
-        self.file_picker_cartas.initial_directory = conf.value.initial_dir.absolute()
+        if conf.value.initial_dir.exists():
+            self.picker_cartas_dir.initial_directory = conf.value.initial_dir.absolute()
 
-        result: FilePickerResult | None = self.file_picker_cartas.pick_files()
-        if result is None or not result.files:
+        path = self.picker_cartas_dir.pick_directory()
+        if not path:
             return
 
-        if self.file_picker_cartas.initial_directory is not None:
-            conf.set_initial_dir(Directory(self.file_picker_cartas.initial_directory))
-
-        controller.generate_table(ArrayList([File(p) for p in result.paths]))
+        folder = Directory(path)
+        conf.set_initial_dir(folder)
+        controller.generate_table_from_folder(folder)
 
     def action_pick_table(self, controller: ControllerForms) -> None:
         if controller.running:
@@ -122,7 +119,7 @@ class _PageRespondsFormsState(StatelessWidget):
                 Row(
                     [
                         ElevatedButton(
-                            "Gerar tabela",
+                            "Gerar tabela (pasta)",
                             lambda: self.action_generate_table(controller),
                         ),
                         ElevatedButton(

{pyflutter_app-0.3.10 → pyflutter_app-0.3.12}/converter/page_image/common.py

@@ -1,11 +1,19 @@
 from __future__ import annotations
 import re
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from enum import StrEnum
 from typing import Final
 
 from table_stream import File
-from cartas import normalizar_data, toi_valido, uc_valida
+from cartas import (
+    normalizar_data,
+    toi_valido,
+    uc_valida,
+    normalizar_data,
+    identificar_por_nome,
+    ResultadoUcToi,
+    OrigemUcToi,
+)
 
 # Extensões que o OpenCV consegue abrir (minúsculas). .svg fica de fora.
 IMAGE_EXTENSIONS: Final[frozenset[str]] = frozenset(
@@ -35,8 +43,7 @@ class FieldError(ValueError):
 def natural_key(f: File) -> list[str | int]:
     """Ordenação natural: img2.jpg vem antes de img10.jpg."""
     return [
-        int(t) if t.isdigit() else t.lower()
-        for t in _RE_NATURAL.split(f.absolute())
+        int(t) if t.isdigit() else t.lower() for t in _RE_NATURAL.split(f.absolute())
     ]
 
 
@@ -82,11 +89,15 @@ class RenameRequest:
         if not uc:
             raise FieldError(FieldName.UC, "Informe a UC (obrigatória).")
         if not _RE_UC.fullmatch(uc):
-            raise FieldError(FieldName.UC, "A UC deve ter apenas números (4 a 10 dígitos).")
+            raise FieldError(
+                FieldName.UC, "A UC deve ter apenas números (4 a 10 dígitos)."
+            )
         if not toi:
             raise FieldError(FieldName.TOI, "Informe o TOI (obrigatório).")
         if not _RE_TOI.fullmatch(toi):
-            raise FieldError(FieldName.TOI, "O TOI deve ter apenas números (4 a 12 dígitos).")
+            raise FieldError(
+                FieldName.TOI, "O TOI deve ter apenas números (4 a 12 dígitos)."
+            )
 
         date: tuple[str, str, str] | None = None
         if date_text:
@@ -128,3 +139,51 @@ class ResultRename:
     cached: bool
     warnings: tuple[str, ...] = ()
     cache_error: Exception | None = None
+
+
+# Extensões aceitas no REGISTRO em cache (o visualizador só abre imagens).
+REGISTER_EXTENSIONS: Final[frozenset[str]] = IMAGE_EXTENSIONS | {".pdf"}
+
+_RE_NAME_UC_TOI: Final = re.compile(r"(\d+)[\s_]+(\d+)")
+_RE_COLLISION: Final = re.compile(r"-\d{1,2}$")
+
+
+def parse_named_file(f: File) -> ResultadoUcToi | None:
+    """
+    Reconhece cartas já nomeadas:
+        '1305934 193166923.pdf'        -> UC TOI  (padrão novo)
+        '2026 11 03 1305934 193166923' -> data + UC + TOI
+        'UC 1305934 TOI 193166923'     -> com rótulos
+    Sufixos de colisão '-1', '-2' são ignorados. None = fora do padrão.
+    """
+    stem = _RE_COLLISION.sub("", f.name().strip()).strip()
+
+    m = _RE_NAME_UC_TOI.fullmatch(stem)
+    if m:
+        uc, toi = m.groups()
+        # UC 6-8 dígitos e TOI 8-10 (evita confundir "2026 11" com UC/TOI).
+        if uc_valida(uc) and toi_valido(toi):
+            return ResultadoUcToi(uc=uc, toi=toi, origem=OrigemUcToi.NOME_ARQUIVO)
+        return None
+
+    return identificar_por_nome(f.basename())
+
+
+@dataclass
+class ResultRegisterNamed:
+    """Resultado do registro em cache de cartas já nomeadas."""
+
+    total: int = 0  # arquivos verificados (imagem/pdf)
+    recognized: int = 0  # hashes únicas reconhecidas pelo nome
+    changed: int = 0  # linhas gravadas/atualizadas no cache TOI
+    with_date: int = 0  # reconhecidas que têm data (chat ou nome)
+    ignored: list[str] = field(default_factory=list)
+    failures: list[tuple[str, Exception]] = field(default_factory=list)
+    warnings: list[str] = field(default_factory=list)
+
+    moved: int = 0  # NOVO: arquivos movidos p/ Retorno-de-campo
+    moves: dict[str, str] = field(default_factory=dict)  # NOVO: caminho antigo -> novo
+
+    @property
+    def without_date(self) -> int:
+        return self.recognized - self.with_date

{pyflutter_app-0.3.10 → pyflutter_app-0.3.12}/converter/page_image/controller_image.py

@@ -15,6 +15,24 @@ from converter.page_image.common import (
 )
 from converter.page_image.model_image import ModelImage
 from converter.page_image.widgets import TextEditingController
+import threading
+from pyflutter_ui.scheduler import MainThreadScheduler
+from converter.page_image.common import (
+    FieldError,
+    FieldName,
+    RenameRequest,
+    ResultRename,
+    ResultRegisterNamed,
+    natural_key,
+)
+
+
+def _ui(fn: Callable[[], None]) -> None:
+    """Executa fn na thread da UI (o registro roda em worker thread)."""
+    try:
+        MainThreadScheduler.run(fn)
+    except RuntimeError:
+        fn()
 
 
 class ControllerImage(ChangeNotifier):
@@ -51,6 +69,9 @@ class ControllerImage(ChangeNotifier):
         self.fn_show_error: Callable[[str], None] | None = None
         self.fn_show_info: Callable[[str], None] | None = None
 
+        self.auto_register: bool = True  # registrar no cache ao importar
+        self._reg_thread: threading.Thread | None = None
+
     # ------------------------------------------------------------------ infra
     def get_config(self) -> AppConfigNotifier:
         return Provider.read(AppConfigNotifier)
@@ -101,11 +122,17 @@ class ControllerImage(ChangeNotifier):
             self.show_error(f"A pasta não existe:\n{folder.absolute()}")
             return
         self.set_status(f"Lendo {folder.absolute()} ...")
-        found = self.model.list_images(folder)
-        self._add(found, f"Pasta {folder.basename()}")
+        images, registrable = self.model.scan_folder(folder)
+        origin = f"Pasta {folder.basename()}"
+        self._add(images, origin)
+        if self.auto_register:
+            self.register_named_files(registrable, origin)  # inclui PDFs
 
     def import_files(self, files: Iterable[File]) -> None:
-        self._add(self.model.filter_images(files), "Imagens selecionadas")
+        images = self.model.filter_images(files)
+        self._add(images, "Imagens selecionadas")
+        if self.auto_register:
+            self.register_named_files(images, "Imagens selecionadas")
 
     def _add(self, found: ArrayList[File], origin: str) -> None:
         known = {f.absolute() for f in self.files}
@@ -128,7 +155,9 @@ class ControllerImage(ChangeNotifier):
                     break
 
         self._select_no_emit(idx)
-        self.set_status(f"{origin}: {len(new)} imagens adicionadas (total {self.total}).")
+        self.set_status(
+            f"{origin}: {len(new)} imagens adicionadas (total {self.total})."
+        )
         self._emit()
         self.uc_input.request_focus()
 
@@ -156,6 +185,103 @@ class ControllerImage(ChangeNotifier):
             self._select_no_emit(min(idx, self.total - 1))
         self._emit()
 
+        # ------------------------------------------------------------------ registrar nomeadas
+
+    def set_auto_register(self, v: bool) -> None:
+        self.auto_register = v  # sem notify: não precisa redesenhar
+
+    def register_named_files(
+        self,
+        files: Iterable[File],
+        origin: str = "Arquivos",
+        organize: bool = False,
+    ) -> None:
+        """Registra no cache TOI (UC/TOI do nome + data do chat) em worker thread."""
+        files = list(files)
+        if not files:
+            return
+        if self._reg_thread is not None and self._reg_thread.is_alive():
+            self.show_info("Já existe um registro de cartas em andamento.")
+            return
+
+        self.set_status(f"{origin}: verificando {len(files)} arquivos ...")
+
+        def progress(done: int, total: int) -> None:
+            if done == total or done % 20 == 0:  # evita rebuild excessivo
+                _ui(
+                    lambda: self.set_status(f"{origin}: registrando {done}/{total} ...")
+                )
+
+        def work() -> None:
+            res: ResultRegisterNamed | None = None
+            err: Exception | None = None
+            try:
+                res = self.model.register_named(files, progress, organize)
+            except Exception as e:
+                err = e
+            _ui(lambda: self._on_registered(origin, res, err))
+
+        self._reg_thread = threading.Thread(
+            target=work, daemon=True, name="image-register"
+        )
+        self._reg_thread.start()
+
+    def _on_registered(
+        self, origin: str, res: ResultRegisterNamed | None, err: Exception | None
+    ) -> None:
+        if err is not None or res is None:
+            self.set_status(f"{origin}: falha ao registrar no cache TOI.")
+            self.show_error(f"Falha ao registrar no cache TOI:\n{err}")
+            return
+
+        # Arquivos movidos: atualiza a lista do visualizador para os novos caminhos.
+        if res.moves:
+            for i, f in enumerate(self.files):
+                new_path = res.moves.get(f.absolute())
+                if new_path is None:
+                    continue
+                if f.absolute() in self.renamed:
+                    self.renamed.discard(f.absolute())
+                    self.renamed.add(new_path)
+                self.files[i] = File(new_path)
+            self.files_version += 1
+            self._emit()
+
+        moved_txt = f" | movidas: {res.moved}" if res.moved else ""
+        self.set_status(
+            f"{origin}: {res.recognized} cartas reconhecidas | "
+            f"{res.changed} gravadas/atualizadas no cache | "
+            f"com data: {res.with_date} | sem data: {res.without_date}"
+            f"{moved_txt}"
+        )
+
+        if res.recognized == 0:
+            self.set_status(
+                f"{origin}: nenhum arquivo no padrão 'UC TOI' "
+                f"({res.total} verificados)."
+            )
+            return
+
+        self.set_status(
+            f"{origin}: {res.recognized} cartas reconhecidas | "
+            f"{res.changed} gravadas/atualizadas no cache | "
+            f"com data: {res.with_date} | sem data: {res.without_date}"
+        )
+
+        problems: list[str] = []
+        if res.without_date:
+            problems.append(
+                f"{res.without_date} carta(s) sem data (não encontradas na tabela WhatsApp). "
+                "Foram gravadas só com UC/TOI; importe de novo depois de atualizar o chat "
+                "para completar a data."
+            )
+        if res.failures:
+            sample = "\n".join(f"{p}: {e}" for p, e in res.failures[:5])
+            problems.append(f"{len(res.failures)} arquivo(s) com falha:\n{sample}")
+        problems.extend(res.warnings)
+        if problems:
+            self.show_info("\n\n".join(problems))
+
     # ------------------------------------------------------------------ navegação
     def select(self, idx: int) -> None:
         self._select_no_emit(idx)