# Guia de Manutenção Contínua — Portal de Transparência PNTP 2026

## 1. Visão Geral

Este guia estabelece os procedimentos de manutenção contínua do Portal de Transparência para garantir a conformidade permanente com os critérios do PNTP 2026.

---

## 2. Rotinas de Manutenção

### 2.1 Rotinas Diárias

| Horário | Atividade | Responsável |
|---|---|---|
| 06:00 | Verificar disponibilidade do portal (uptime) | Monitoramento automático |
| 06:00 | Verificar execução dos pipelines ETL | Monitoramento automático |
| 07:00 | Verificar atualização de dados (data de referência) | Equipe de TI |
| 08:00 | Verificar links quebrados | Ferramenta automatizada |
| 09:00 | Verificar performance de carregamento | Ferramenta automatizada |

**Checklist diário:**
- [ ] Portal acessível (HTTP 200)
- [ ] Dados atualizados (data de referência ≤ 30 dias)
- [ ] Pipelines ETL executados com sucesso
- [ ] Sem links quebrados (404)
- [ ] Performance adequada (LCP < 2,5s)

---

### 2.2 Rotinas Semanais

| Dia | Atividade | Responsável |
|---|---|---|
| Segunda | Revisão de filtros de pesquisa | Equipe de TI |
| Terça | Revisão de exportações de dados | Equipe de TI |
| Quarta | Revisão de declarações de inexistência | Equipe de conteúdo |
| Quinta | Revisão de acessibilidade | Equipe de TI |
| Sexta | Revisão de logs de acesso | Equipe de TI |

**Checklist semanal:**
- [ ] Todos os filtros funcionando
- [ ] Todas as exportações funcionando
- [ ] Declarações de inexistência atualizadas
- [ ] Acessibilidade verificada
- [ ] Logs revisados

---

### 2.3 Rotinas Mensais

| Semana | Atividade | Responsável |
|---|---|---|
| 1ª semana | Atualização de dados estáticos (organograma, contatos) | Equipe de conteúdo |
| 2ª semana | Revisão de legislação | Jurídico |
| 3ª semana | Revisão de performance | Equipe de TI |
| 4ª semana | Relatório de conformidade | Equipe de TI |

**Checklist mensal:**
- [ ] Organograma atualizado
- [ ] Contatos atualizados
- [ ] Legislação revisada
- [ ] Performance revisada
- [ ] Relatório de conformidade gerado

---

### 2.4 Rotinas Anuais

| Mês | Atividade | Responsável |
|---|---|---|
| Janeiro | Revisão completa de todos os critérios | Equipe de TI |
| Fevereiro | Atualização de legislação anual | Jurídico |
| Março | Revisão de acessibilidade | Equipe de TI |
| Abril | Publicação do Balanço Geral | Contabilidade |
| Maio | Revisão de performance | Equipe de TI |
| Junho | Pesquisa de satisfação | Ouvidoria |
| Julho | Revisão de segurança | Equipe de TI |
| Agosto | Atualização de dados estáticos | Equipe de conteúdo |
| Setembro | Revisão de filtros | Equipe de TI |
| Outubro | Preparação para avaliação PNTP | Equipe de TI |
| Novembro | Testes finais | Equipe de TI |
| Dezembro | Relatório anual | Equipe de TI |

---

## 3. Monitoramento

### 3.1 Métricas de Monitoramento

| Métrica | Meta | Ferramenta |
|---|---|---|
| Uptime | > 99,5% | UptimeRobot, Pingdom |
| Tempo de resposta | < 500ms | New Relic, Datadog |
| LCP | < 2,5s | Lighthouse |
| FID | < 100ms | Lighthouse |
| CLS | < 0,1 | Lighthouse |
| Erros 5xx | < 0,1% | Sentry |
| Taxa de sucesso ETL | > 99% | Airflow |

### 3.2 Alertas

| Condição | Severidade | Ação |
|---|---|---|
| Portal indisponível | Crítica | Acionar equipe imediatamente |
| Pipeline ETL falhou | Alta | Verificar e reexecutar |
| Dados não atualizados em > 24h | Alta | Verificar fonte de dados |
| Performance degradada | Média | Investigar e otimizar |
| Erro de validação | Baixa | Registrar e corrigir |

### 3.3 Dashboard de Monitoramento

```
┌─────────────────────────────────────────────────────────────┐
│                    DASHBOARD DE MONITORAMENTO                │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  Uptime: 99.8%  │  LCP: 1.8s  │  Erros: 0.02%              │
│                                                             │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  Pipelines ETL:                                             │
│  ✅ Receita (06:00)                                         │
│  ✅ Despesa (06:05)                                         │
│  ✅ Servidores (06:10)                                      │
│  ⚠️ Licitações (06:15) - 2 erros                           │
│                                                             │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  Última atualização por dimensão:                           │
│  Receita: 15/01/2026 06:00                                  │
│  Despesa: 15/01/2026 06:05                                  │
│  Servidores: 15/01/2026 06:10                               │
│  Licitações: 14/01/2026 06:15 (desatualizado)               │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

---

## 4. Gestão de Incidentes

### 4.1 Classificação de Incidentes

| Nível | Descrição | SLA de Resposta | SLA de Resolução |
|---|---|---|---|
| **P1 - Crítico** | Portal indisponível | 15 minutos | 2 horas |
| **P2 - Alto** | Dados não atualizados | 1 hora | 4 horas |
| **P3 - Médio** | Performance degradada | 4 horas | 24 horas |
| **P4 - Baixo** | Erro de validação | 24 horas | 72 horas |

### 4.2 Procedimento de Resposta

```
1. Detectar incidente (monitoramento ou usuário)
2. Classificar incidente (P1-P4)
3. Acionar equipe responsável
4. Investigar causa raiz
5. Implementar solução
6. Verificar resolução
7. Documentar incidente
8. Post-mortem (se P1 ou P2)
```

### 4.3 Comunicação de Incidentes

| Nível | Canal | Destinatários |
|---|---|---|
| P1 | Telefone + SMS + E-mail | Equipe de TI + Gestores |
| P2 | SMS + E-mail | Equipe de TI |
| P3 | E-mail | Equipe de TI |
| P4 | E-mail | Equipe de TI |

---

## 5. Backup e Recuperação

### 5.1 Política de Backup

| Tipo | Frequência | Retenção | Local |
|---|---|---|---|
| Banco de dados | Diária | 30 dias | Nuvem + Local |
| Arquivos estáticos | Diária | 30 dias | Nuvem + Local |
| Configurações | Semanal | 90 dias | Nuvem |
| Backup completo | Mensal | 1 ano | Nuvem |

### 5.2 Teste de Recuperação

- [ ] Testar recuperação mensalmente
- [ ] Documentar tempo de recuperação
- [ ] Verificar integridade dos dados recuperados

---

## 6. Atualizações e Melhorias

### 6.1 Processo de Atualização

```
1. Identificar necessidade de atualização
2. Planejar atualização
3. Desenvolver em ambiente de staging
4. Testar em ambiente de staging
5. Aprovar para produção
6. Deploy em produção
7. Verificar em produção
8. Documentar atualização
```

### 6.2 Janelas de Manutenção

| Dia | Horário | Duração |
|---|---|---|
| Domingo | 02:00 - 06:00 | 4 horas |
| Quarta | 02:00 - 04:00 | 2 horas |

---

## 7. Documentação

### 7.1 Documentos Obrigatórios

- [ ] Arquitetura do portal
- [ ] Documentação da API
- [ ] Manuais de operação
- [ ] Procedimentos de manutenção
- [ ] Plano de contingência
- [ ] Relatórios de conformidade

### 7.2 Versionamento

- Todo código versionado (Git)
- Documentação versionada
- Changelog mantido

---

## 8. Treinamento

### 8.1 Equipe de TI

- [ ] Treinamento inicial no portal
- [ ] Treinamento em pipelines ETL
- [ ] Treinamento em monitoramento
- [ ] Treinamento em segurança

### 8.2 Equipe de Conteúdo

- [ ] Treinamento em publicação de conteúdo
- [ ] Treinamento em atualização de dados
- [ ] Treinamento em declarações de inexistência

---

## 9. Checklist de Manutenção

### 9.1 Diário

- [ ] Portal acessível
- [ ] Dados atualizados
- [ ] Pipelines executados
- [ ] Sem links quebrados
- [ ] Performance adequada

### 9.2 Semanal

- [ ] Filtros funcionando
- [ ] Exportações funcionando
- [ ] Declarações atualizadas
- [ ] Acessibilidade verificada
- [ ] Logs revisados

### 9.3 Mensal

- [ ] Dados estáticos atualizados
- [ ] Legislação revisada
- [ ] Performance revisada
- [ ] Relatório de conformidade gerado

### 9.4 Anual

- [ ] Revisão completa de critérios
- [ ] Atualização de legislação
- [ ] Revisão de acessibilidade
- [ ] Publicação do Balanço Geral
- [ ] Revisão de performance
- [ ] Pesquisa de satisfação
- [ ] Revisão de segurança
- [ ] Preparação para avaliação PNTP
- [ ] Testes finais
- [ ] Relatório anual
