1. O problema
Um colega de Ministério Público, integrante de um grupo de atuação especial, disse-me numa conversa casual que vinha tendo muito trabalho nas prorrogações de prazos de inquéritos civis.
Nessas ocasiões, ele precisava fazer um relatório minucioso de tudo que havia sido incorporado aos autos, o que se afigurava bastante desafiador, considerados o volume de documentos, a complexidade dos procedimentos e a quantidade de casos sob sua responsabilidade.
Imaginei que o problema poderia ser mitigado se a inclusão de documentos aos expedientes pudesse ser registrada uma a uma, ao longo do tempo, num sistema que os resumisse automaticamente, com o uso de inteligência artificial, e que, no momento oportuno, gerasse o relatório desejado.
Prototipei essa ideia no recesso forense de 2025/2026 e compartilho por aqui todo o código e o aprendizado acumulado.
2. O programa
O programa concebido consiste numa aplicação desktop que registra cada inclusão de documento a algum procedimento, no momento em que ela acontece.
Na tela principal, o usuário localiza o procedimento em curso ou cadastra um novo. Seguindo, carrega o documento a ele relacionado e que será juntado aos autos. Uma chamada à LLM permite que a solução identifique automaticamente a natureza do documento e apresente o resumo estruturado de seu conteúdo, de acordo com o prompt definido num arquivo ".env", que também contém a chave da API. O usuário poderá editar esses campos antes de salvar o registro.
O sistema disponibiliza consultas ou gera relatórios editáveis dos documentos incorporados a determinado procedimento, por ordem cronológica, ou dos documentos cadastrados, independentemente do procedimento, também por ordem cronológica.
3. Tecnologias empregadas
4. Arquitetura
5. Modelagem dos dados (Model)
Estruturamos o banco de dados em duas tabelas relacionadas: procedimentos e documentos.
A tabela procedimentos contém o conjunto de procedimentos administrativos, mediante a inserção de um número identificador único e a natureza do procedimento. A tabela documentos armazena os registros de documentos individuais por meio de seus títulos e resumos, incluindo automaticamente a data de criação de cada registro.
Utiliza-se o relacionamento de "um para muitos", vinculando cada documento a um procedimento específico através de uma Chave Estrangeira (Foreign Key), que aponta para a Chave Primária da tabela de procedimentos. Pela regra de integridade configurada (ON DELETE SET NULL), caso um procedimento seja excluído, os documentos associados a ele permanecem no sistema com o vínculo removido (campo preenchido como nulo), preservando-se o histórico documental.
As tabelas podem ser geradas pelo código SQL abaixo, que vem precedido da ativação do suporte a chaves estrangeiras:
CREATE TABLE IF NOT EXISTS procedimentos (
id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
numero TEXT NOT NULL UNIQUE,
descricao TEXT
);
CREATE TABLE IF NOT EXISTS documentos (
id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
titulo TEXT NOT NULL,
resumo TEXT,
data_criacao TEXT DEFAULT CURRENT_TIMESTAMP,
procedimento TEXT REFERENCES procedimentos (numero) ON DELETE SET NULL
);
6. Montando a interface (View)
As interfaces (tela principal e tela de cadastro) foram desenhadas com o Qt Designer. Esse programa permite que os componentes sejam arrastados para as janelas e nela posicionados de forma prática e direta.
As telas criadas são salvas no formato "ui".
pyside6-uic <seu_arquivo.ui> -o <seu_arquivo.py>
Obtido o arquivo "py" da interface, você pode se dedicar ao arquivo main.py e escrever a lógica do programa. Assegure-se de importar a classe MainWindow do arquivo "py" gerado pelo PySide6, para estabelecer as conexões entre botões e campos e funções do programa.
O "esqueleto" do main.py é o seguinte.
from PySide6.QtWidgets import QApplication, QMainWindow
from ui import Ui_MainWindow
def __init__(self):
super().__init__()
self.setupUi(self)
if __name__ == "__main__":
app.setStyle("Fusion")
window = MainWindow()
window.show()
sys.exit(app.exec())
Ao executá-lo, você já poderá visualizar a sua janela em loop.
7. Ligando a interface ao BD (Controller)
Para criar a lógica do programa, precisamos entender duas coisas:- As conexões devem ser feitas preferencialmente dentro do método __init__, logo após a chamada do self.setupUi(self). Isso garante que todos os widgets já foram criados antes de você tentar conectar algo a eles.
- As funções que executam a lógica (ex: o que acontece ao clicar em um botão) devem ser criadas como métodos da classe. Isso permite que elas acessem os elementos da interface através do self.
from PySide6.QtWidgets import QApplication, QMainWindow
from ui import Ui_MainWindow
super().__init__()
self.setupUi(self)
self.botao_enviar.clicked.connect(self.ao_clicar_no_botao)
# --- DEFINIÇÃO DAS FUNÇÕES (COMO MÉTODOS DA CLASSE) ---
def ao_clicar_no_botao(self):
print("O botão foi clicado!")
# EXEMPLO DE ACESSO A OUTROS WIDGETS:
# texto = self.campo_input.text()
A maior complexidade reside na exibição e edição da tabela documentos, da qual são extraídos os relatórios. A estratégia se aproveita da classe QSqlTableModel do Qt, que funciona como um intermediário reativo entre o banco de dados e a interface gráfica. Essa abordagem permite que a tableView reflita automaticamente o conteúdo da tabela "documentos", simplificando a implementação de filtros dinâmicos através do método setFilter. Sempre que um critério de busca é alterado no sistema, o comando select() é invocado para sincronizar a visualização com o estado atual do banco de dados, garantindo que o usuário visualize apenas as informações pertinentes de forma eficiente.
Para a atualização e inserção de registros, o código adota uma abordagem híbrida: permite a edição direta de células na interface via OnFieldChange e utiliza a classe QSqlQuery com prepared statements para cadastrar novos procedimentos e documentos. Após cada inserção, o método select() do modelo é chamado novamente para atualizar a grade de exibição, mantendo a consistência entre o que está armazenado no SQLite3 e o que é apresentado na tela.
8. Conclusão
A criação deste protótipo funcional é um exemplo claro de como ferramentas de IA podem contribuir para a otimização de fluxos de trabalho e economia de tempo, liberando o Promotor de Justiça para tarefas mais estratégicas e de maior relevância.Código
Você encontra o código completo dessa aplicação em: https://github.com/jespimentel/pj_docs.
Não se esqueça de acrescentar o arquivo .env, nos moldes sugeridos acima.
