Schema do Banco | RV Store API

tabela

users

Usuários do sistema — clientes e administradores. Base para o Laravel Sanctum.

11 colunas

Coluna Tipo Flags Notas

id BIGINT UNSIGNED PK AUTO_INCREMENT

name VARCHAR(150) NN

email VARCHAR(255) UQ NN

email_verified_at DATETIME NULL

password VARCHAR(255) NN Bcrypt hash

avatar VARCHAR(500) NULL

telefone VARCHAR(30) NULL

role ENUM(super_admin,admin,cliente) NN Default: cliente

status ENUM(ativo,suspenso,inativo) NN Default: ativo

remember_token VARCHAR(100) NULL

created_at / updated_at TIMESTAMP NULL

tabela

enderecos

Endereços de entrega do cliente. Suporte a múltiplos endereços com marcação de padrão.

11 colunas

Coluna Tipo Flags Notas

id BIGINT UNSIGNED PK AUTO_INCREMENT

user_id BIGINT UNSIGNED FK ON DELETE CASCADE

nome_destinatario VARCHAR(150) NN

telefone VARCHAR(30) NN

provincia VARCHAR(100) NN

municipio VARCHAR(100) NN

bairro VARCHAR(150) NULL

rua VARCHAR(255) NULL

referencia TEXT NULL Ponto de referência

is_padrao BOOLEAN NN Default: FALSE

created_at / updated_at TIMESTAMP NULL

tabela

categorias

Categorias de produtos para navegação e filtragem do catálogo.

8 colunas

Coluna Tipo Flags Notas

id BIGINT UNSIGNED PK AUTO_INCREMENT

nome VARCHAR(100) NN

slug VARCHAR(120) UQ NN URL amigável

descricao TEXT NULL

imagem VARCHAR(500) NULL

ativo BOOLEAN NN Default: TRUE

ordem SMALLINT NN Default: 0

created_at / updated_at TIMESTAMP NULL

tabela

produtos

Tabela central do catálogo. Cada produto tem categoria, preço base, natureza e flags de destaque/ativo.

19 colunas

Coluna Tipo Flags Notas

id BIGINT UNSIGNED PK AUTO_INCREMENT

code VARCHAR(50) UQ NN Código único do produto

nome VARCHAR(200) NN

slug VARCHAR(220) UQ NN URL amigável

descricao TEXT NULL

id_categoria BIGINT UNSIGNED FK ON DELETE RESTRICT

avaliacao DECIMAL(2,1) NN Default: 0.0 — média das avaliações

frete BOOLEAN NN TRUE = disponível p/ entrega

tipo_frete ENUM(gratis,fixo,calculado,retirada) NULL

garantia VARCHAR(100) NULL Ex: 6 meses, 1 ano

preco DECIMAL(12,2) NN Preço base em AOA

old_price DECIMAL(12,2) NULL Preço anterior (riscado)

natureza ENUM(masculino,feminino,unissex) NN Default: unissex

cor VARCHAR(80) NULL

link VARCHAR(500) NULL URL amigável / afiliado

destaque BOOLEAN NN Default: FALSE

ativo BOOLEAN NN Default: TRUE

vendas_total INT UNSIGNED NN Default: 0

created_at / updated_at TIMESTAMP NULL

tabela

produto_variacoes

Variações de tamanho/cor por produto. Cada variação tem estoque, SKU e acréscimo de preço próprio.

9 colunas

Coluna Tipo Flags Notas

id BIGINT UNSIGNED PK AUTO_INCREMENT

produto_id BIGINT UNSIGNED FK ON DELETE CASCADE

tamanho VARCHAR(20) NN P, M, G, GG, XL, 38, 40…

cor VARCHAR(60) NULL Variação de cor, se houver

quantidade INT UNSIGNED NN Estoque disponível — Default: 0

sku VARCHAR(80) UQ NULL Stock Keeping Unit

preco_adicional DECIMAL(10,2) NN Acréscimo sobre preço base — Default: 0.00

ativo BOOLEAN NN Default: TRUE

created_at / updated_at TIMESTAMP NULL

tabela

produto_imagens

Múltiplas imagens por produto. Uma pode ser marcada como principal.

7 colunas

Coluna Tipo Flags Notas

id BIGINT UNSIGNED PK AUTO_INCREMENT

produto_id BIGINT UNSIGNED FK ON DELETE CASCADE

url VARCHAR(500) NN

alt VARCHAR(200) NULL Texto alternativo

principal BOOLEAN NN Default: FALSE

ordem SMALLINT NN Default: 0

created_at / updated_at TIMESTAMP NULL

tabela

produto_avaliacoes

Reviews de produtos. Um cliente só pode avaliar cada produto uma vez (unique composto).

7 colunas

Coluna Tipo Flags Notas

id BIGINT UNSIGNED PK AUTO_INCREMENT

produto_id BIGINT UNSIGNED FK ON DELETE CASCADE

user_id BIGINT UNSIGNED FK ON DELETE CASCADE

nota TINYINT UNSIGNED NN 1 a 5

comentario TEXT NULL

aprovado BOOLEAN NN Default: FALSE — moderação

created_at / updated_at TIMESTAMP NULL

Nota: UQ (produto_id, user_id) — impede duplicata de avaliação.

tabela

promocoes

Promoções por produto ou categoria com vigência de datas.

9 colunas

Coluna Tipo Flags Notas

id BIGINT UNSIGNED PK AUTO_INCREMENT

code VARCHAR(50) UQ NN Código único da promoção

id_produto BIGINT UNSIGNED FK NULL NULL = promoção por categoria

id_categoria BIGINT UNSIGNED FK NULL ON DELETE SET NULL

price_promo DECIMAL(12,2) NN Preço promocional em AOA

data_inicio DATE NN

data_fim DATE NN

ativo BOOLEAN NN Default: TRUE

created_at / updated_at TIMESTAMP NULL

tabela

cupons

Cupons de desconto. Suporta percentagem ou valor fixo, com limite de usos e validade.

14 colunas

Coluna Tipo Flags Notas

id BIGINT UNSIGNED PK AUTO_INCREMENT

code_cupom VARCHAR(50) UQ NN Código que o cliente digita

descricao VARCHAR(200) NULL

tipo ENUM(percentagem,valor_fixo) NN Default: percentagem

percentagem_desconto DECIMAL(5,2) NULL Usado quando tipo = percentagem

valor_desconto DECIMAL(12,2) NULL Usado quando tipo = valor_fixo (AOA)

valor_minimo_pedido DECIMAL(12,2) NN Mínimo para aplicar — Default: 0.00

data_inicio DATE NN

data_fim DATE NULL NULL = sem expiração

vitalicio BOOLEAN NN Default: FALSE

limite_uso INT UNSIGNED NULL NULL = ilimitado

usos_realizados INT UNSIGNED NN Default: 0

ativo BOOLEAN NN Default: TRUE

created_at / updated_at TIMESTAMP NULL

tabela

carrinhos

Sessão de carrinho. Pode ser de um utilizador autenticado ou visitante (via session_token).

4 colunas

Coluna Tipo Flags Notas

id BIGINT UNSIGNED PK AUTO_INCREMENT

user_id BIGINT UNSIGNED FK NULL NULL = visitante — ON DELETE CASCADE

session_token VARCHAR(100) NULL IDX Identifica visitante anónimo

created_at / updated_at TIMESTAMP NULL

tabela

carrinho_itens

Itens dentro de um carrinho. Armazena snapshot do preço unitário no momento da adição.

7 colunas

Coluna Tipo Flags Notas

id BIGINT UNSIGNED PK AUTO_INCREMENT

carrinho_id BIGINT UNSIGNED FK ON DELETE CASCADE

produto_id BIGINT UNSIGNED FK ON DELETE CASCADE

variacao_id BIGINT UNSIGNED FK NULL NULL = sem variação — ON DELETE SET NULL

quantidade INT UNSIGNED NN Default: 1

preco_unitario DECIMAL(12,2) NN Snapshot do preço no momento da adição

created_at / updated_at TIMESTAMP NULL

tabela

pedidos

Cabeçalho de cada venda. Guarda snapshot do endereço, totais financeiros, status e dados de pagamento.

23 colunas

Coluna Tipo Flags Notas

id BIGINT UNSIGNED PK AUTO_INCREMENT

code VARCHAR(20) UQ NN Ex: ORD-7721

user_id BIGINT UNSIGNED FK ON DELETE RESTRICT

endereco_id BIGINT UNSIGNED FK NULL ON DELETE SET NULL

endereco_snap JSON NULL Cópia imutável do endereço no momento da compra

status ENUM(pendente,pago,em_separacao,enviado,entregue,cancelado,devolvido) NN Default: pendente

subtotal DECIMAL(12,2) NN AOA

desconto_promo DECIMAL(12,2) NN Default: 0.00

desconto_cupom DECIMAL(12,2) NN Default: 0.00

frete_valor DECIMAL(12,2) NN Default: 0.00

total DECIMAL(12,2) NN AOA

cupom_id BIGINT UNSIGNED FK NULL ON DELETE SET NULL

cupom_code VARCHAR(50) NULL Snapshot do código do cupom

metodo_pagamento ENUM(whatsapp,transferencia,multicaixa,cartao,outro) NN Default: whatsapp

pagamento_status ENUM(aguardando,confirmado,falhou,reembolsado) NN Default: aguardando

pagamento_ref VARCHAR(255) NULL Referência externa do gateway

pago_em DATETIME NULL

whatsapp_enviado BOOLEAN NN Default: FALSE

whatsapp_msg TEXT NULL Mensagem gerada p/ WhatsApp

codigo_rastreio VARCHAR(100) NULL

enviado_em / entregue_em DATETIME NULL

observacoes TEXT NULL

created_at / updated_at TIMESTAMP NULL

tabela

pedido_itens

Linhas do pedido. Snapshots de nome, código, tamanho e cor para histórico imutável.

14 colunas

Coluna Tipo Flags Notas

id BIGINT UNSIGNED PK AUTO_INCREMENT

pedido_id BIGINT UNSIGNED FK ON DELETE CASCADE

produto_id BIGINT UNSIGNED FK ON DELETE RESTRICT

variacao_id BIGINT UNSIGNED FK NULL ON DELETE SET NULL

produto_nome VARCHAR(200) NN Snapshot

produto_code VARCHAR(50) NN Snapshot

variacao_tamanho VARCHAR(20) NULL Snapshot

variacao_cor VARCHAR(60) NULL Snapshot

imagem_url VARCHAR(500) NULL Snapshot

quantidade INT UNSIGNED NN

preco_unitario DECIMAL(12,2) NN AOA

desconto_item DECIMAL(12,2) NN Default: 0.00

subtotal DECIMAL(12,2) NN (preco_unitario − desconto_item) × quantidade

created_at / updated_at TIMESTAMP NULL

tabela

pedido_historico

Auditoria de mudanças de status em cada pedido. Regista quem alterou e quando.

7 colunas

Coluna Tipo Flags Notas

id BIGINT UNSIGNED PK AUTO_INCREMENT

pedido_id BIGINT UNSIGNED FK ON DELETE CASCADE

status_anterior VARCHAR(50) NULL

status_novo VARCHAR(50) NN

observacao TEXT NULL

alterado_por BIGINT UNSIGNED FK NULL Admin que alterou — ON DELETE SET NULL

created_at TIMESTAMP NULL Sem updated_at — registo imutável

tabela

wishlists

Lista de desejos do cliente. Unique composto impede duplicata.

4 colunas

tabela

banners

Banners da home com suporte a vigência de datas e ordenação.

9 colunas

Coluna Tipo Flags Notas

id BIGINT UNSIGNED PK AUTO_INCREMENT

titulo VARCHAR(200) NN

subtitulo VARCHAR(300) NULL

imagem_url VARCHAR(500) NN URL pública da imagem

link VARCHAR(500) NULL Destino do clique

status ENUM(ativo,inativo) NN Default: ativo

ordem SMALLINT NN Default: 0

data_inicio / data_fim DATE NULL Vigência opcional

created_at / updated_at TIMESTAMP NULL

tabela

notificacoes

Notificações para clientes e admins. NULL em user_id significa broadcast global.

8 colunas

Coluna Tipo Flags Notas

id BIGINT UNSIGNED PK AUTO_INCREMENT

user_id BIGINT UNSIGNED FK NULL NULL = global — ON DELETE CASCADE

tipo VARCHAR(80) NN novo_pedido, estoque_baixo, pagamento_confirmado…

titulo VARCHAR(200) NN

mensagem TEXT NULL

lida BOOLEAN NN Default: FALSE

link VARCHAR(500) NULL Rota p/ redireccionar ao clicar

created_at TIMESTAMP NULL Sem updated_at — imutável

tabela

configuracoes

Chave-valor de configurações da loja. Sem created_at — só updated_at.

6 colunas

Coluna Tipo Flags Notas

id BIGINT UNSIGNED PK AUTO_INCREMENT

chave VARCHAR(100) UQ NN Ex: loja_nome, moeda

valor TEXT NULL

tipo ENUM(string,boolean,number,json) NN Default: string

descricao VARCHAR(300) NULL

updated_at TIMESTAMP NULL Sem created_at

Nota: Valores padrão inseridos via seed: loja_nome, loja_whatsapp, moeda (AOA), frete_gratis_acima, estoque_alerta_min.