# Instalação e Banco de Dados

<section class="capitulo" id="bkmrk-antes-de-usar-o-sist">Antes de usar o sistema, é preciso instalar os módulos e criar as tabelas que guardam clientes, pagamentos e avaliações do totem.

<section class="para-todos">## Em linguagem simples

A equipe de Tecnologia da Informação precisa rodar a **instalação** dos módulos no servidor. Isso cria um "caderno de anotações" digital (banco de dados) onde ficam guardados:

- Os **dados dos clientes** que já consultaram a fatura.
- O **histórico de pagamentos** feitos na loja.
- As **notas de satisfação** que o cliente dá no totem (de 1 a 5).

Sem essa instalação, o portal e o totem não conseguem salvar informações.

</section>![Passos de instalação](https://kb.illimitar.pro/uploads/images/gallery/2026-06/embedded-image-qlkfgjw4.png)

*Figura 3 — Ordem das migrações do instalador (88e14c87): v1 cria o banco; v2, v3 e v4 criam as tabelas.*

<section class="para-ti">## Detalhes para Tecnologia da Informação

### Instalador

Arquivo: `bibliotecas/88e14c87-…/instalador.php`

Rota: `/bibliotecas/88e14c87-…/api_integracao_credsystem_pagamento_total/install`

Dependência: `util.php` (`12262a22-30ab-11e9-bb4c-127101af6b0d`)

### Migrações

<table><thead><tr><th>Versão</th><th>Ação</th></tr></thead><tbody><tr><td>v1</td><td>`CREATE DATABASE IF NOT EXISTS {banco}_integrador`</td></tr><tr><td>v2</td><td>Cria tabela `cred_cliente` (Notação de Objetos JavaScript: `cpf`, `nome`, `codigoCliente`, `diaMesNascimento`)</td></tr><tr><td>v3</td><td>Cria tabela `cred_pagamento` (`cpf`, entidade, usuário, caixa, valor Notação de Objetos JavaScript, tipo, situação)</td></tr><tr><td>v4</td><td>Cria tabela `cred_satisfacao` (`cpf`, nota 1–5)</td></tr></tbody></table>

### Schema cred\_pagamento

<table><thead><tr><th>Coluna</th><th>Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>`cpf_cliente`</td><td>varchar(14)</td><td>Cadastro de Pessoa Física sem formatação</td></tr><tr><td>`id_entidade`</td><td>int</td><td>Loja/entidade</td></tr><tr><td>`id_usuario`</td><td>int</td><td>Operador</td></tr><tr><td>`id_caixa`</td><td>int</td><td>Caixa do Ponto de Venda</td></tr><tr><td>`valor`</td><td>Notação de Objetos JavaScript</td><td>Detalhes do pagamento</td></tr><tr><td>`pagamento`</td><td>varchar</td><td>`DINHEIRO` ou `PIX`</td></tr><tr><td>`situacao`</td><td>varchar</td><td>`EFETIVADO` ou `ESTORNADO`</td></tr></tbody></table>

### Outros módulos

- `981bfb94` — instalador vazio (sem migrações).
- `857e21c5` — usa tabela existente `configuracao_usuario`.

### Ordem recomendada de instalação

1. Instalar `981bfb94` (Interface de Programação de Aplicações Credsystem)
2. Instalar `88e14c87` (executar v1 → v4)
3. Instalar `857e21c5` (gestor)
4. Configurar entidade (capítulo 04)

</section></section>