Capacidade compartilhada ou independente
Vários tipos de ingresso podem consumir a mesma vaga real, como adultos e crianças compartilhando uma capacidade, ou manter sua própria capacidade separada para uma categoria reservada.
Capacidade e estoque
Zero vagas significa zero vagas.
Nada de ler um número e depois escrever um número. Cada reivindicação de capacidade ou de um código de estoque é uma única operação condicional no banco de dados, então duas compras pela mesma vaga, no mesmo instante, nunca podem vencer as duas.
- 1 escrita Cada reivindicação é uma única operação SQL condicional, nunca "ler e depois escrever"
- Compartilhada ou independente Vários tipos de ingresso podem consumir a mesma vaga, ou ter a sua própria
- Até 5 tentativas Se um código de estoque perde a corrida para outra reivindicação, tenta o próximo antes de desistir
Quatro peças do estoque.
Cada uma modela um tipo diferente de restrição real.
Exceções de capacidade
Reduz ou amplia a capacidade para uma data, um intervalo de datas ou um horário específico, sem criar um novo grupo nem alterar o padrão que rege o resto do calendário.
Recursos compartilhados
Guias, veículos ou equipamentos podem sustentar uma capacidade e ser compartilhados entre produtos, modelando restrições de equipe, não só de espaço físico.
Estoque de terceiros
Códigos comprados antecipadamente de um fornecedor externo, importados por CSV em segundo plano, com validade própria e detecção de duplicados.
Como uma vaga é reivindicada, sem vender além da conta
Cinco passos, toda vez que algo reserva um pedaço de estoque.
- 1
A linha é encontrada ou criada
Cada combinação de data e horário tem sua própria linha de contagem, criada na primeira vez que alguém a reivindica, herdando a capacidade de alguma exceção vigente, ou o padrão do grupo.
- 2
Uma única escrita condicional
A reivindicação soma retido, reservado e a quantidade pedida, e só é aplicada se esse total não ultrapassar a capacidade. Sem ler antes, sem intervalo entre ler e escrever.
- 3
Se não couber, é rejeitada
Se a condição falha, a escrita não afeta nenhuma linha e a tentativa é rejeitada de imediato. Não existe janela onde duas reivindicações possam passar pela mesma condição ao mesmo tempo.
- 4
Retenção e confirmação
Um pagamento pendente retém a vaga em seu próprio contador. Se o pagamento se confirma, ela vira reservada; se expira ou é cancelada, é liberada, sem nunca afetar o que já está reservado de verdade.
- 5
Códigos de estoque, mesmo princípio
Reivindicar um código de estoque segue a mesma lógica: escolhe-se o candidato disponível mais antigo, e a atualização só é aplicada se ele ainda estiver disponível naquele instante exato; se perder a corrida, tenta o próximo.
O que "restante" realmente significa
A mesma consulta de calendário retorna a capacidade restante por tipo de ingresso, não um número único compartilhado. Dois tipos que compartilham uma capacidade mostram o mesmo número; um reservado e independente mostra o seu próprio.
GET /api/v1/products/observation-deck/calendar
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
{
"date": "2026-08-14",
"slots": [
{
"start_time": "18:00",
"remaining_capacity": {
"adult": 12,
"child": 12,
"accessible": 4
}
}
]
}200 Capacidade resolvida
Uma capacidade sem limite nunca carrega números fantasmas
Se uma capacidade não tem limite, reivindicá-la nunca soma nada a "retido": não há nada para contar. Confirmar ou liberar essa mesma retenção segue exatamente a mesma regra, mesmo parecendo redundante, porque se essa capacidade um dia passar de ilimitada para limitada, esses contadores precisam realmente começar do zero, sem carregar subtrações de números que nunca foram somados.
Perguntas frequentes
Só uma vence. A reivindicação é uma única operação condicional no banco de dados: soma a quantidade pedida e só se aplica se o total ficar dentro da capacidade. A segunda compra simplesmente falha nessa condição e é rejeitada, sem nenhuma janela onde as duas pudessem passar.
Sim, se configurado assim. Vários tipos de ingresso, até de opções ou produtos diferentes, podem apontar para a mesma capacidade: vender um reduz o que sobra para os outros. Também é possível manter uma capacidade separada e totalmente independente para uma categoria reservada.
Com uma exceção de capacidade: uma data, um intervalo de datas ou um horário específico com sua própria capacidade, sem criar um novo grupo nem alterar o padrão que rege o resto do calendário.
Ela fica retida em seu próprio contador, separado do que já está reservado de verdade. Se o pagamento se confirma, ela vira reservada; se expira ou é cancelada, é liberada automaticamente, sem nunca afetar vendas já fechadas.
Sim. Cada código é reivindicado com a mesma lógica atômica: escolhe-se o disponível mais antigo, e a atualização só é aplicada se ele ainda estiver disponível naquele instante exato. Se perder a corrida contra outra reivindicação, o sistema tenta o próximo candidato, até cinco vezes, antes de desistir.
Mais reservas. Mais canais. A mesma calma.
A Tiqory mantém disponibilidade, preços, pagamentos e acesso a trabalhar juntos enquanto a sua operação cresce. Conte-nos para onde vai; mostramos como chegar lá sem recomeçar.