Cadastro de atração
A atração define o que existe para vender e quais comportamentos ela aceita. É o primeiro cadastro de qualquer implantação.
Onde fica
Menu lateral → Atrações → Nova atração.
Quem pode manter
Criar, editar, arquivar e reordenar exigem attractions.manage. Apenas visualizar exige attractions.view.
Campos
| Campo | Obrigatório | Descrição | Formato ou exemplo | Observações |
|---|---|---|---|---|
| Nome * | sim | Nome exibido na loja, no voucher e no portão. | “Piscinas”, “Churrasqueiras” | Até 80 caracteres, com contador. Único por empresa, inclusive contra arquivadas. Erro: “Nome é obrigatório”. |
| Tipo * | sim | Natureza da atração. | Permanente · Evento | Padrão: Permanente. Aparece como selo na listagem. |
| Status * | sim | Interruptor de venda. | Ativa · Inativa | Padrão: Ativa. Inativa não vende, mas continua no catálogo. |
| Descrição | não | Texto de apoio exibido na loja. | “Descrição resumida da atração” | Texto livre. |
| Imagem | não | Foto usada na vitrine. | JPG, PNG, WEBP ou GIF | Máximo de 5 MB. Erros literais: “Arquivo inválido: envie uma imagem (JPG, PNG, WEBP ou GIF).” e “Imagem muito grande. O tamanho máximo é 5 MB.” |
| Gera ocorrências | não | Permite criar datas e regras de recorrência. | Ligada por padrão | Desligada, bloqueia a criação de ocorrências e regras. |
| Aceita passaportes | não | Permite pendurar tipos de ingresso. | Desligada por padrão | Precisa ser ligada antes de criar passaportes. |
| Aceita produtos | não | Permite vincular produtos à atração. | Desligada por padrão | Produto sem vínculo com atração não depende desta flag. |
Aceita passaportes e aceita produtos vêm desligadas.
Se você criar a atração e for direto criar o passaporte, receberá o erro
attraction_no_passport — em inglês, sem tradução. Ligue as flags primeiro.
Aviso de nome semelhante
Enquanto você digita o nome, o sistema procura atrações com trecho parecido (inclusive arquivadas) e mostra “Atrações com nome semelhante: …”. É apenas informativo, pode dar falso positivo e não bloqueia o salvamento. O bloqueio real acontece só se o nome for idêntico.
O que acontece ao salvar
- A atração passa a existir no catálogo e pode receber ocorrências, passaportes, produtos e complementos, conforme as flags.
- Se estiver ativa e tiver datas e ingressos publicados, aparece na loja.
- Autor e data ficam registrados; na edição, cada campo alterado gera uma linha de auditoria.
O que impede a conclusão
- Nome em branco.
- Nome já usado por outra atração da empresa, mesmo arquivada — mensagem: “Já existe uma atração com esse nome nesta empresa (ativa ou arquivada). Escolha outro nome ou desarquive a existente.”
- Ao restaurar: conflito com atração ativa de mesmo nome — “Já existe uma atração ativa com esse nome nesta empresa. Renomeie antes de desarquivar.”
- Imagem em formato não aceito ou acima de 5 MB.
Como arquivar e o que isso causa
Se houver ingressos vendidos para datas futuras, o sistema recusa com a mensagem: “Esta atração tem N ingresso(s) vendido(s) em datas futuras. Remarque ou reembolse essas vendas antes de arquivar.”
- Arquivada, a atração some da listagem principal, mas os ingressos já vendidos continuam válidos.
- Não existe exclusão definitiva: passaportes, vouchers e itens de venda continuam apontando para ela.
- Arquivar pela listagem não gera registro de auditoria; pela tela de detalhe, gera.
Relacionamentos
- Ocorrências — as datas.
- Passaportes — os ingressos.
- Produtos — itens vinculados.
- Complementos — outras atrações ofertadas junto.
- Vouchers e vendas — histórico que impede a exclusão.
Exemplo de preenchimento (fictício)
| Nome | Piscinas |
|---|---|
| Tipo | Permanente |
| Status | Ativa |
| Descrição | Área de piscinas com toboáguas e área infantil. |
| Gera ocorrências | Ligada |
| Aceita passaportes | Ligada |
| Aceita produtos | Ligada |