Central de Ajuda e Manuais

Bem-vindo à plataforma de automação e inteligência artificial da COSAMPA. Este sistema foi projetado para capturar, analisar e armazenar de forma inteligente as imagens e documentos das obras.

1. Importação Excel (📥 O Ponto de Partida Automático)

Esta é a ferramenta principal para carregar obras em lote no sistema.

• Clique na aba Importar (ícone 📥) na barra lateral.
• Arraste e solte o seu arquivo .xlsx (planilha de controle) na área indicada.
• O sistema validará automaticamente as colunas e inserirá todas as obras na Fila de Processamento.
• O robô começará imediatamente a baixar os arquivos de todas as obras, sempre começando pelas obras com menor quantidade de fotos.
• Nesta etapa inicial de download, a Inteligência Artificial NÃO é acionada, garantindo agilidade e economia. O sistema apenas organiza e redimensiona as fotos para salvar espaço.

2. Processamento Manual (📤 Upload Direto)

Use esta tela caso você não tenha uma planilha e precise processar imagens de uma única obra rapidamente a partir do seu próprio computador.

• Arraste as fotos que você quer processar para o quadro principal.
• Preencha o "Número da Obra" e o "Nome da Obra".
• Você pode reordenar as imagens arrastando-as se desejar forçar uma ordem específica.
• Clique no botão de enviar para acionar a Inteligência Artificial.

3. O Drive de Obras (📁 Visualização e Gestão)

Esta é a sua biblioteca digital. Tudo que o robô finalizar (ou o que você enviar manualmente) aparecerá aqui.

• Processando: O robô está trabalhando nesta obra agora.
• Pendente: A obra foi processada, mas ainda precisa de alguma revisão ou atenção.
• Concluído: A obra está finalizada e perfeita. (Apenas neste status o botão de Arquivar fica disponível).

4. Novo Fluxo de Trabalho Ideal (Resumo Diário)

1. Pela manhã, suba sua planilha de obras na Importação Excel.
2. O robô iniciará automaticamente o download e a organização de TODAS as obras da planilha para o seu computador, ordenadas da mais leve para a mais pesada.
3. Após a conclusão do download, as obras ficarão com o status "Pronto para IA".
4. Escolha apenas as obras que você realmente precisa que sejam validadas e clique no botão "PROCESSAR IA". Só então os dados serão enviados para o Gemini.
5. Acompanhe o progresso das suas obras no Drive durante o dia e limpe as Pendências caso a IA encontre fotos ilegíveis.

Este sistema funciona de forma assíncrona e paralela, o que significa que o Painel Web e o Robô de IA trabalham ao mesmo tempo. Veja como eles reagem às suas ações:

1. Priorizar uma Obra Manualmente (Botão ⚡ Priorizar)

Ação: O usuário clica no botão "⚡ Priorizar" em uma obra que está na fila Aguardando.

Como reage: O robô NÃO interrompe o download atual! Ele finalizará a obra que está baixando neste exato momento de forma segura. Assim que ela terminar, ele puxará imediatamente a sua obra priorizada como a próxima da fila, ignorando a ordem de quantidade de fotos.

2. Pausar o Robô no Painel Admin

Ação: O usuário clica no botão "Pausar Robô".

Como reage: O robô não para "congelado no tempo". Ele termina a obra atual (até 100%) e só então se recusa a puxar a próxima da fila. Se você precisar interromper no meio da obra para salvar o disco, pause o processo no terminal do servidor.

3. Limpar a Fila com Obras Processando

Ação: O usuário clica em "Limpar Fila" ou exclui a obra atual do robô.

Como reage: O robô, na próxima tentativa de salvar uma foto, não encontrará a obra. Ele emitirá um erro no terminal (abortando o processo). Contudo, algumas fotos processadas residuais podem ficar presas no Drive e precisarão ser apagadas manualmente.

4. Re-processar uma Obra (Erro)

Ação: O usuário clica no botão "Tentar Novamente" em uma obra com erro.

Como reage: O robô tratará ela como uma obra completamente nova. O interessante é que a primeira etapa (Download) será instantânea porque o robô utiliza o arquivo Zip em cache na VPS. Ele apenas retomará a IA nas imagens.