MÓDULO DE ACOMPANHAMENTO PÚBLICO DE OS
Prefeitura de Extrema - Gerência de Tecnologia

INSTALAÇÃO

1. Faça backup dos arquivos atuais:
   - listar_os.php
   - nova_os.php
   - finalizar_os.php
   - confirmar_retirada.php

2. Copie todos os arquivos desta pasta para a raiz do sistema.

3. Os quatro arquivos acima devem substituir as versões atuais.

4. Mantenha sem autenticação pública:
   - acompanhar_os.php
   - registrar_ciencia_os.php
   - avaliar_os.php

   Eles usam token seguro e não incluem auth.php.

5. Arquivos internos protegidos por auth.php:
   - listar_os.php
   - nova_os.php
   - finalizar_os.php
   - confirmar_retirada.php
   - gerenciar_acompanhamento_os.php
   - ativar_acompanhamento_existentes.php

6. Como as tabelas já foram criadas, não é necessário importar SQL.

7. Para gerar links para OS antigas, abra uma vez:
   ativar_acompanhamento_existentes.php

8. No listar_os.php, clique no botão “Acompanhar” de qualquer OS.
   O modal permite:
   - gerar/copiar link;
   - abrir painel público;
   - gerar QR Code;
   - ativar/desativar acompanhamento;
   - gerar novo token;
   - publicar mensagem pública;
   - consultar ciência da retirada;
   - consultar avaliação.

FLUXO AUTOMÁTICO

Nova OS:
- gera token;
- ativa acompanhamento;
- publica “Solicitação recebida”.

Finalização técnica:
- status PENDENTE RETIRADA;
- publica “Equipamento pronto para retirada”.

Retirada:
- status Finalizado;
- publica “Equipamento entregue”;
- libera avaliação pública.

SEGURANÇA

- O painel não usa ID sequencial.
- O token possui 48 caracteres hexadecimais aleatórios.
- Não são exibidos problema, solução, anexos, IPs ou dados internos.
- Patrimônio e nome do solicitante aparecem parcialmente protegidos.
- O painel pode ser desativado ou ter o token regenerado.