# Módulo `fin_indiceinflacao`

Cadastro e manutenção do índice de inflação (IPCA) no SAG.

## Estrutura

- `index.php` - listagem e ações
- `cad.php` - cadastro/edição manual
- `insert.php` - persistência
- `delete.php` - soft delete (`status=2`)
- `select.php` - consulta com filtros
- `filtro.php` - tela de filtros
- `integracao_ipca.py` - integração automática de múltiplos índices (catálogo)

## Banco de Dados

Execute o script na raiz:

- `migration_fin_indiceinflacao.sql`

## Integração IPCA (Python)

Dependência:

- `pip install psycopg2-binary`

Exemplo de execução (todas as empresas ativas + todos os índices ativos do catálogo):

```bash
python fin_indiceinflacao/integracao_ipca.py --data-inicial 01/01/2015
```

Para carregar apenas uma empresa específica:

```bash
python fin_indiceinflacao/integracao_ipca.py --empresa 1 --data-inicial 01/01/2015
```

Para forçar uma série específica manualmente (sem usar catálogo):

```bash
python fin_indiceinflacao/integracao_ipca.py --empresa 1 --indice IPCA --fonte BCB_SGS --serie 433 --data-inicial 01/01/2015
```

Parâmetros de conexão podem vir por argumentos ou variáveis de ambiente:

- `SAG_DB_NAME`
- `SAG_DB_USER`
- `SAG_DB_PASSWORD`
- `SAG_DB_HOST`
- `SAG_DB_PORT`

## Observações

- Catálogo de índices em `fin_indice_catalogo` (ativação por `ativo=1` e `tipo_carga='API'`)
- Cálculo de acumulado no ano e acumulado 12 meses já é gravado na tabela
- Chave única evita duplicidade por `empresa + indice + serie + competencia` na tabela `fin_indiceinflacao`
