Código Sequencial da Venda
Toda Venda recebe, no momento da criação, um código legível e sequencial por tenant (academia/rede), usado para identificação do pedido pelo aluno e pela equipe da academia.
Formato
O código segue o padrão PED-NNNN, com o número sequencial preenchido com zeros à esquerda até 4 dígitos:
| Exemplo | Descrição |
|---|---|
|
Primeira venda registrada para o tenant. |
|
Segunda venda do mesmo tenant. |
|
Décima venda do mesmo tenant. |
O contador é isolado por tenant (saas_id): cada academia/rede começa sua própria sequência em PED-0001, independentemente de quantas vendas outros tenants já tenham registrado.
Geração
-
O código é gerado exclusivamente pelo backend-store no momento da criação da venda — não é calculado nem montado no frontend.
-
É armazenado em uma tabela de contador dedicada por tenant, incrementada de forma atômica a cada nova venda, evitando condição de corrida entre vendas concorrentes do mesmo tenant.
-
O limite do contador é
9999por tenant; ao tentar criar a 10000ª venda de um mesmo tenant, o backend rejeita a operação (422).
O formato usa sempre 4 dígitos (PED-0001, nunca PED-001). Qualquer código de exemplo, mock ou fixture usado em documentação, testes ou protótipos de UI deve seguir esse padrão.
|