Ferramentas/RCVinculaPartesLivroAntigo

VinculaPartes – Ajuste de Vínculo de Noivos no SIRC

Aplicação em Python (empacotada em .exe) criada para corrigir e vincular os dados dos noivos entre as tabelas:

• V_CASAMENTO
• V_PESSOA_VINCULO (que referencia V_PESSOA)

Essa correção é necessária porque, na tela do SIRC, os dados são validados com base nos registros de V_PESSOA_VINCULO. Sem esse vínculo correto, os dados dos noivos podem não aparecer ou não ser validados adequadamente.

---

1. Como a aplicação funciona

1. Lê os dados dos noivos em V_CASAMENTO Para cada casamento, a aplicação busca as informações dos noivos já cadastradas nessa view/tabela.

2. Verifica se a pessoa já existe em V_PESSOA

   • Se já existir cadastro da pessoa:
     • A aplicação apenas cria o vínculo correto em V_PESSOA_VINCULO.
   • Se não existir:
     • A aplicação cria um novo registro em V_PESSOA com base nos dados de V_CASAMENTO;
     • Em seguida, cria o vínculo desse registro recém-criado com o casamento em V_PESSOA_VINCULO.

3. Resultado esperado

   • Todos os noivos presentes em V_CASAMENTO passam a ter:
     • Um registro correspondente em V_PESSOA (quando necessário);
     • Um vínculo correto em V_PESSOA_VINCULO, permitindo a validação correta no SIRC.

---

2. Dependência do config.ini

A aplicação deve ser executada na mesma pasta em que está o arquivo config.ini.

• O config.ini contém os dados de acesso ao banco de dados.
• A aplicação reutiliza essas mesmas credenciais para conectar no banco (host, porta, usuário, senha, caminho da base, etc.).
• Sem o config.ini correto na mesma pasta, a aplicação não conseguirá conectar ao banco.

🔹 Em resumo: VinculaPartes.exe (ou main.py) e config.ini precisam estar lado a lado na mesma pasta.

---

3. Execução

3.1. Pré-requisitos (modo desenvolvimento – Python)

• Python instalado
• Biblioteca fdb instalada (pip install fdb)
• fbclient.dll acessível (na pasta do projeto ou em local conhecido)
• Arquivo config.ini configurado com os dados do banco

Para executar via Python:

python main.py

Certifique-se de que:

• main.py
• config.ini
• fbclient.dll estão na mesma pasta (ou com caminhos corretamente configurados).

3.2. Execução do executável (.exe)

Após gerado o executável:

• Copie para a mesma pasta:
  • VinculaPartes.exe
  • config.ini
  • fbclient.dll (se necessário)
• Dê duplo clique no VinculaPartes.exe ou execute pelo Prompt de Comando:

VinculaPartes.exe

---

4. Build do executável com PyInstaller

Para gerar o executável em modo one-file com ícone e dependências embutidas, utilize o comando:

pyinstaller --onefile --name "VinculaPartes" --icon="images/icon.ico" --hidden-import=fdb --add-binary "fbclient.dll;." main.py

Descrição dos parâmetros principais:

• --onefile Gera um único arquivo executável.
• --name "VinculaPartes" Define o nome do executável gerado.
• --icon="images/icon.ico" Define o ícone do executável.
• --hidden-import=fdb Garante que o PyInstaller inclua a biblioteca fdb no build.
• --add-binary "fbclient.dll;." Inclui o fbclient.dll e o disponibiliza na mesma pasta do executável.
• main.py Arquivo principal da aplicação.

Após a compilação, o executável será gerado na pasta dist/:

dist/
└── VinculaPartes.exe

---

5. Resumo

• A aplicação corrige o vínculo dos noivos entre V_CASAMENTO, V_PESSOA e V_PESSOA_VINCULO.
• É fundamental para que os dados sejam validados corretamente no SIRC.
• Depende do config.ini para conectar ao banco de dados.
• Pode ser executada via Python (main.py) ou via executável (VinculaPartes.exe) gerado com PyInstaller.

Qualquer alteração futura na estrutura das tabelas ou nas regras de negócio deve ser refletida na lógica da aplicação antes de nova execução em produção.