# Manual do Perfil Iluminação

## 1. Finalidade

O perfil `Iluminação` foi criado para operar demandas do setor de iluminação pública sem interferir no fluxo dos demais setores.

Esse perfil:

- visualiza apenas demandas do `NÚCLEO DE ILUMINAÇÃO`
- usa formulário próprio
- possui impressão de OS
- aceita importação de relatórios `.odt` do setor

## 2. Campos do cadastro

No perfil `Iluminação`, o formulário utiliza:

- `Número da ordem`
  - gerado automaticamente
- `Tipo`
  - Memorando
  - Processo
  - Telefone
  - Demanda de vistoria
- `Assunto`
  - Manutenção de luminária
  - Troca de luminária
  - Instalação de Luminária
  - Demandas Bairro a Bairro
  - Extensão de Rede
  - Remoção de cabos de telefonia
  - Remoção de estrutura (poste e fiação)
  - Manutenção predial
  - Manutenção em praças e espaços públicos
  - Ligação de rede para eventos em espaços públicos
- `Endereço`
- `Complemento`
- `Observações`
- `Origem/Processo`
- `Destino`
  - fixo em `NÚCLEO DE ILUMINAÇÃO`
- `Requerente`
- `Contato`
- `Equipe`
  - CM 192
  - CM 178
  - CM 193
  - CM 282
  - CM 144
  - CM 191
- `Vereador`
- `Tramitação`
- `Execução`
- `Situação`

## 3. Regras do perfil

- o número é gerado automaticamente
- o destino fica travado em `NÚCLEO DE ILUMINAÇÃO`
- a equipe é opcional no cadastro
- a equipe também pode ser definida depois, direto na listagem

## 4. Cadastro de demanda

1. preencha os campos
2. clique em `Registrar demanda`
3. o sistema gera o número automaticamente

## 5. Equipes

A equipe pode ser atribuída de duas formas:

- no cadastro
- diretamente na listagem, dentro de `Ações`

Isso permite distribuir rapidamente as ordens para:

- CM 192
- CM 178
- CM 193
- CM 282
- CM 144
- CM 191

## 6. Ordem de Serviço

Demandas de iluminação possuem botão:

- `Emitir OS`

A OS:

- é impressa em uma via
- ocupa meia folha A4
- mostra as informações principais:
  - número
  - tipo
  - data
  - equipe
  - requerente
  - contato
  - assunto
  - endereço
  - observações

## 7. Importação de relatórios ODT

O perfil suporta importação de relatórios `.odt` de iluminação.

Fluxo:

1. clique em `Importar XLSX/ODT`
2. selecione o arquivo `.odt`
3. revise o preview
4. confirme a importação

O parser tenta identificar:

- protocolo/número
- tipo
- assunto
- endereço
- requerente
- vereador
- execução
- observações

## 8. Normalização de vereadores

O sistema já unifica aliases conhecidos, por exemplo:

- Edgar Gomes
- Nharam Vieira de Carvalho
- Renato Orlando Tiecher
- Giordani Krug Campos Ramos

## 9. Mapa e georreferenciamento

O perfil `Iluminação` também pode usar:

- mapa georreferenciado
- auditoria de pendências
- geocodificação assistida
- georreferenciamento manual

## 10. Apoio por IA

No setor de iluminação, a IA ajuda em:

- triagem do assunto
- leitura de anexos
- normalização de endereço
- detecção de duplicidade
- insights por demanda
- agrupamentos territoriais
- previsão de atraso

## 11. Boas práticas operacionais

- preencher endereço com o máximo de detalhe possível
- usar `Contato` quando houver telefone do solicitante
- revisar `Equipe` antes da emissão da OS
- revisar dados importados no preview antes de confirmar