Preflight de CSV de reservas de hotel para nuvem com Claude Code
Revise CSVs de hotel antes da nuvem: dados pessoais, consentimento, chaves de objeto e aprovação.
Na sexta-feira à tarde, a recepção se prepara para um fim de semana lotado e a agência de marketing pede a exportação mais recente de reservas. Alguém baixa o CSV do sistema do hotel e, antes de enviar, percebe que a chave planejada na nuvem ainda contém o e-mail de uma hóspede. Outra linha traz uma nota de cancelamento com informação familiar. O problema não é apertar o botão de upload; é saber quais linhas podem sair do hotel, quais valores precisam ser removidos e quem aprovou a entrega.
Dados de reserva em hotelaria e turismo misturam muito mais que datas e quartos. Eles podem incluir nomes, e-mails, telefones, acompanhantes, planos, valores, pedidos de alimentação, necessidades de acessibilidade e observações livres. Entrega na nuvem significa colocar arquivos em um local acessível pela rede para outro time ou fornecedor. Isso é útil, mas CSV, chave de objeto, link assinado e e-mail de aviso são superfícies diferentes de exposição.
Este artigo mostra como usar Claude Code para criar um contrato de preflight antes de qualquer upload. Contrato aqui não é contrato jurídico; é um acordo técnico repetível sobre colunas obrigatórias, valores aceitos, nomes de objeto, consentimento, data de exclusão e revisão humana. O título promete uma checagem prévia, não uma integração cloud ao vivo. O código usa apenas uma fixture local e não chama AWS S3, Google Cloud Storage, Cloudflare R2 nem outro serviço real.
Pontos principais
- O fluxo ajuda hotéis e turismo a preparar CSVs de reservas antes da entrega na nuvem.
- Claude Code verifica colunas, datas, consentimento, chaves de objeto e gera um manifesto pseudonimizado.
- Pessoas decidem finalidade, escopo do fornecedor, retenção, contrato e notas sensíveis.
- O limite testado é apenas sintaxe JavaScript e execução local de fixture. Autenticação, rede, upload, permissões e exclusão não foram testados.
- A única CTA principal é treinamento e consultoria para transformar o fluxo em regra interna.
Fluxo de trabalho: transformar o CSV em manifesto de entrega
Os primeiros artefatos são concretos: CSV exportado do sistema de reservas, finalidade de negócio, regra de nome de chave de objeto, data planejada de exclusão e checklist do responsável. Em vez de anexar o CSV bruto ou soltá-lo em um bucket compartilhado, o time roda uma checagem local e cria um manifesto. O manifesto lista arquivos previstos, data de exclusão e status de revisão sem expor nomes de hóspedes.
Como o fluxo fica entre agente de código e armazenamento em nuvem, fontes oficiais importam. Para Claude Code, consulte a documentação de permissões da Anthropic. Para armazenamento, leia as boas práticas de segurança do AWS S3 e as URLs assinadas do Google Cloud Storage. Elas ajudam a transformar expiração curta, menor privilégio e revisão de acesso em checklist.
flowchart TD
A[Colocar CSV localmente] --> B[Claude Code inspeciona colunas e valores]
B --> C[Checar chaves e consentimento]
C --> D[Criar manifesto pseudonimizado]
D --> E[Pessoa aprova finalidade e fornecedor]
E --> F[Upload apenas depois da aprovação]
Fluxos próximos aparecem em agência de viagens e metadados de imagens turísticas na nuvem. Aqui o foco é o passo intermediário: evitar erros antes de entregar CSV de reservas a terceiros.
O que Claude Code faz e o que pessoas decidem
Claude Code é útil para checagens repetíveis de contrato de entrada. Ele pode apontar colunas ausentes, checkout antes do check-in, valores não numéricos, consentimento diferente de yes, chaves que parecem conter e-mail e linhas que exigem revisão. Também pode gerar manifesto com ID da reserva, chave de objeto, datas, data de exclusão e marcador de revisão.
Pessoas decidem se a entrega é adequada. Um responsável precisa saber qual explicação o hóspede recebeu, se o contrato cobre armazenamento e subprocessadores, se observações livres são necessárias, se há saúde, religião, família ou acessibilidade, e se o fornecedor precisa de dados linha a linha ou de relatório agregado. A saída do Claude Code é material de revisão, não conclusão legal nem aprovação de privacidade.
O padrão seguro é não entregar credenciais de upload ao Claude Code durante o preflight. Comece com pasta local somente leitura e amostra fictícia ou pseudonimizada. Comando de upload, credenciais, criação de URL assinada e mudanças de permissão ficam em etapa separada com aprovação humana. Regras de negação e diretório de trabalho estreito reduzem leituras acidentais e comandos não planejados.
Três casos de uso
Caso de uso 1: Encontrar colunas faltantes em exportações OTA
Entrada: CSV com ID da reserva, nome do hóspede, e-mail, check-in, checkout, valor, consentimento e chave de objeto. OTA é agência de viagens online; hotéis com vários canais recebem nomes de coluna e formatos diferentes.
Saída: tabela de colunas faltantes, valores vazios, datas inválidas, estadia invertida e valores não numéricos. O responsável decide reexportar, corrigir a amostra local ou excluir uma linha da entrega.
Revisão humana: confirmar se cada canal tem a mesma finalidade permitida. Consentimento para instruções de estadia não equivale a marketing, análise ou processamento por fornecedor.
Caso de uso 2: Remover dados pessoais das chaves de objeto
Entrada: chaves candidatas como hotel-a/2026-08/[email protected], com nomes, e-mails e telefones. Chave de objeto é o identificador do arquivo no armazenamento.
Saída: chaves com e-mail, telefone ou trecho de nome são marcadas. Uma chave mais segura é hotel-a/2026-08/booking-BK001.csv.
Revisão humana: decidir se o ID de reserva é seguro para o fornecedor. Se ele permite voltar ao PMS, pode ser necessário um ID de entrega separado.
Caso de uso 3: Criar manifesto para o fornecedor
Entrada: CSV checado, finalidade, data de exclusão, nome do fornecedor e checklist de aprovação.
Saída: manifesto pseudonimizado, data de exclusão, status de revisão e número de erros abertos. Não é o corpo do CSV, mas o registro que autoriza ou bloqueia o upload.
Revisão humana: antes de enviar, confirmar contrato, finalidade, retenção, contato de suporte e rota de escalonamento. Também decidir se o fornecedor precisa de todas as linhas ou só de um resumo.
Prompt para copiar
Atue como revisor de preflight para um CSV de reservas de hotel antes da entrega na nuvem.
Objetivo:
Checar CSV, chaves de objeto, consentimento e data de exclusão, e produzir manifesto que uma pessoa possa aprovar antes do upload.
Entrada:
- Colunas CSV:
- Amostra do CSV:
- Finalidade de negócio:
- Fornecedor:
- Data de exclusão:
- Regra de chave de objeto:
- Critérios de aprovação humana:
Saída:
1. Colunas faltantes e valores inválidos
2. Chaves que parecem conter dados pessoais
3. Linhas sem consentimento suficiente
4. Manifesto pseudonimizado
5. Pontos que exigem julgamento humano
6. Checklist antes do upload
Restrições:
- Não conectar a serviço real de nuvem
- Não manter dados pessoais nos exemplos
- Não afirmar conclusão legal
- Não inserir ClaudeCodeLab, /training/ ou CTA do site no artefato gerado
Código executável de checagem
Para salvar, use um caminho como tools/hotel-booking-handoff-preflight.mjs no seu repositório. Este artigo não implica que esse arquivo já exista aqui. O código lê apenas fixture fixa; não usa SDK, CLI, API, credenciais nem rede.
const requiredColumns = [
"booking_id",
"guest_name",
"email",
"checkin",
"checkout",
"amount_jpy",
"consent",
"object_key"
];
const bookingCsv = `booking_id,guest_name,email,checkin,checkout,amount_jpy,consent,object_key
BK001,Aoi Sato,[email protected],2026-09-01,2026-09-03,42000,yes,hotel-a/2026-09/booking-BK001.csv
BK002,Ren Mori,[email protected],2026-09-05,2026-09-04,31000,yes,hotel-a/2026-09/booking-BK002.csv
BK003,Mika Ito,[email protected],2026-09-08,2026-09-10,not-a-number,no,hotel-a/2026-09/[email protected]`;
function parseCsv(text) {
const [headerLine, ...rows] = text.trim().split("\n");
const headers = headerLine.split(",");
return rows.map((line) => {
const values = line.split(",");
return Object.fromEntries(headers.map((header, index) => [header, values[index] ?? ""]));
});
}
function isIsoDate(value) {
return /^\d{4}-\d{2}-\d{2}$/.test(value) && !Number.isNaN(Date.parse(value));
}
function validateRows(rows) {
const errors = [];
const manifest = [];
for (const [index, row] of rows.entries()) {
for (const column of requiredColumns) {
if (!(column in row) || row[column].trim() === "") {
errors.push(`row ${index + 1}: missing ${column}`);
}
}
if (isIsoDate(row.checkin) && isIsoDate(row.checkout) && row.checkin >= row.checkout) {
errors.push(`row ${index + 1}: checkout must be after checkin`);
}
if (!Number.isFinite(Number(row.amount_jpy))) {
errors.push(`row ${index + 1}: amount_jpy must be numeric`);
}
if (row.consent !== "yes") {
errors.push(`row ${index + 1}: consent must be yes before handoff`);
}
const hasPersonalKeyPattern = /@|(?:^|[^\d])(?:\+?\d{2,}[- ]\d{2,}[- ]\d{3,})(?:[^\d]|$)/.test(row.object_key);
if (hasPersonalKeyPattern || row.object_key.includes(row.guest_name.split(" ")[0].toLowerCase())) {
errors.push(`row ${index + 1}: object_key may contain personal data`);
}
manifest.push({
booking_id: row.booking_id,
object_key: row.object_key,
checkin: row.checkin,
checkout: row.checkout,
delete_after: "2026-10-31",
reviewer_required: true
});
}
return { errors, manifest };
}
const rows = parseCsv(bookingCsv);
const result = validateRows(rows);
console.log(JSON.stringify(result, null, 2));
Esse código prova apenas que a fixture local pode ser checada por colunas, datas, valores, consentimento e padrões de chave. Ele não prova permissões de nuvem, geração de URL assinada, sucesso de upload, recebimento pelo fornecedor, retenção nem exclusão. Misturar esses limites faz o time confundir “checado localmente” com “compartilhado com segurança”.
Armadilhas e correções
Armadilha 1: cada canal usa nomes de coluna diferentes. Um export usa guest_name, outro name; um usa arrival, outro checkin. Sem tabela de mapeamento, Claude Code não deve assumir equivalência. Correção: manter uma tabela de colunas e revisar antes e depois da conversão.
Armadilha 2: chaves legíveis demais. Nomes, e-mails, telefones, notas de quarto ou motivos de cancelamento no caminho expõem dados sem abrir o arquivo. Correção: usar ID de reserva, pastas por mês e nomes neutros, sem nomes no manifesto.
Armadilha 3: juntar consentimento em uma caixa. Instruções de estadia, marketing, processamento por fornecedor, pesquisa e análise multiunidade são finalidades diferentes. Correção: separar colunas por finalidade e bloquear linhas sem permissão.
Armadilha 4: tratar upload bem-sucedido como segurança. Ele só prova que o serviço aceitou o objeto. Correção: separar preflight local, revisão pós-upload de permissões e revisão de retenção.
Medição pequena de ROI
Não invente economia. Por uma semana, registre reexportações de CSV, e-mails de devolução do fornecedor, linhas corrigidas antes do upload, minutos de aprovação e linhas bloqueadas por falta de consentimento. Isso mostra se o retrabalho caiu.
O ROI deve olhar redução de retrabalho e risco, não receita imediata. Compare minutos por entrega, minutos de correção por arquivo rejeitado, linhas abertas na aprovação e problemas capturados antes de o fornecedor ver o arquivo. Como cada hotel tem volume diferente, o artigo não afirma benchmark.
Perguntas frequentes
Q. Posso colar o CSV real no Claude Code?
A. Comece com amostra mínima pseudonimizada. Para dados de produção, defina regras internas, contratos, permissões, logs e retenção antes.
Q. URL assinada é segura por padrão?
A. Ela limita tempo e ação, mas destinatário, expiração, permissões e encaminhamento continuam importantes. Leia a documentação oficial e use expiração curta e menor privilégio.
Q. Qual nuvem o hotel deve escolher?
A. Este artigo não compara produtos. Escolha pela plataforma padrão, logs de auditoria, modelo de permissões, operação de exclusão e forma de recebimento do fornecedor.
Q. Quando pedir ajuda?
A. Antes de reutilizar CSV de reservas para terceirização, campanhas, análise ou compartilhamento entre unidades. Se o time discute as mesmas checagens toda semana, treinamento e consultoria pode transformar o fluxo em regra clara.
O que eu realmente testei
Em 2026-08-21, mantive o JavaScript executável com node --input-type=module -e e confirmei que a fixture fixa emite lista de erros e JSON de manifesto. É checagem de sintaxe e execução local. Não testei autenticação de nuvem, URL assinada, upload, mudança de permissões, recebimento pelo fornecedor nem exclusão.
Também selecionei heroImage como /images/hero/hero-040.webp, correspondente a site/public/images/hero/hero-040.webp, e revisei slug, datas de frontmatter, links internos, CTA e URLs oficiais. O próximo passo é criar uma amostra pseudonimizada de três linhas e adaptar colunas obrigatórias e regra de chave à política do hotel.
Artigos relacionados
Respostas de cancelamento de hotel com Claude Code: tabela segura antes do envio
Revise cancelamentos e mudanças de data sem enviar números de reserva ou dados do hóspede para IA.
Recepção de hotel com Claude Code: agilize confirmação de reserva, FAQ e resposta a avaliações
Para hotéis: agilize confirmação de reserva, FAQ e resposta a avaliações com Claude Code, com prompts prontos e cuidado com dados pessoais.
Preflight de Cloud Run Jobs para inspeção industrial com Claude Code
Revise CSV de inspeção, fotos, aprovações, variáveis e secrets antes de passar ao Cloud Run Jobs.
PDF grátis: cheatsheet do Claude Code
Informe seu e-mail e baixe uma página com comandos, hábitos de revisão e workflows seguros.
Cuidamos dos seus dados e não enviamos spam.
Sobre o autor
Masa
Engenheiro focado em workflows práticos com Claude Code.