iFriend DataFlow — Manual do Usuário¶

Bem-vindo! Este manual é para quem vai usar o DataFlow no dia a dia — não é preciso saber programar nem entender de tecnologia para acompanhar.

Para quem é este site? Para o time que recebe tarifários dos parceiros e precisa publicá-los no TravelCompositor e/ou no iFriend Manager. Se você procura documentação técnica de arquitetura ou código, esse conteúdo vive em outro site, voltado a desenvolvedores.

O que o DataFlow faz, em uma frase¶

Você envia o tarifário de um parceiro (PDF, Excel ou Word) e o DataFlow organiza os produtos, preços e temporadas automaticamente — e, a partir disso, você publica o produto no TravelCompositor e/ou no iFriend Manager (depende do que está habilitado para sua empresa) sem precisar montar esse cadastro à mão.

flowchart LR
    A[Você envia<br/>o tarifário]:::in --> B[A IA lê e organiza<br/>os produtos e preços]:::ai
    B --> C[Você revisa<br/>o resultado]:::review
    C --> D[Publica no<br/>TravelCompositor]:::tc
    C --> E[Publica no<br/>iFriend Manager]:::tc

    classDef in fill:#3f6cd6,color:#fff;
    classDef ai fill:#7c3aed,color:#fff;
    classDef review fill:#f59e0b,color:#1a1a1a;
    classDef tc fill:#6b7280,color:#fff;

Por que isso importa¶

Tarifários de parceiros chegam em formatos diferentes, com preços por temporada, por tipo de quarto, por regime, por idade — copiar isso manualmente é lento e sujeito a erro. O DataFlow lê o documento, entende essa estrutura e organiza tudo num modelo único, sempre com uma etapa de revisão humana antes de qualquer coisa ir para produção.

Por onde comecar¶

Se você quer...	Vá em...
Entender o fluxo completo, do início ao fim	Visão geral do fluxo
Saber quais arquivos pode enviar	Enviar o tarifário
Entender o que a IA extraiu e como revisar	Revisar a extração
Saber o que checar antes de baixar a planilha	Planilha e validação
Dar instruções específicas para um fornecedor difícil	Skills e instruções de extração
Ver o que você já extraiu antes / baixar de novo	Histórico de extrações
Configurar sua conta e publicar um produto no TravelCompositor	Publicação no TravelCompositor
Configurar sua conta e publicar um produto no iFriend Manager	Publicação no iFriend Manager
Gerenciar usuários ou empresas (só para administradores)	Administração
Tirar uma dúvida rápida	Perguntas frequentes
Resolver um problema que apareceu na tela	Problemas comuns

Uma regra que vale para tudo¶

Nada é publicado "escondido": todo produto novo entra no TravelCompositor desativado (active=false) até alguém da equipe revisar e ativar manualmente. O DataFlow também tem um modo de simulação (dry-run) que mostra o que seria enviado sem realmente publicar nada — é o caminho seguro para testar antes de publicar de verdade.