GitLab

Visão Geral

Este banco de dados suporta toda a criação e relacionamento das entidades necessárias para funcionamento da API do Coopera-RS. Armazena todas as entidades necessárias para o relacionamento de usuários, produtos e compras.

Foram utilizados o PostgreSQL 15 como banco de dados relacional e o Redis como banco de dados não relacional.

1. Modelagem

1.1 Modelo Conceitual

A modelagem conceitual foi feita utilizando a ferramenta Astah Professional:

1.2 Modelo Lógico

A modelagem lógica foi feita utilizando a ferramenta online DrawSQL, por oferecer suporte às funcionalidades específicas do PostgreSQL:

2. Diagrama do Banco de Dados (DER)

drawSQL-image-export-2025-06-16.png

3. Tabelas

Abaixo segue uma descrição detalhada de cada tabela no banco de dados.

3.1. Tabela user (client)

A tabela user foi criada como client para evitar a palavra reservada 'user' do SQL. No entanto, toda a modelagem seguiu a nomenclatura 'user' para manter maior lógica semântica.

O user é o usuário base da aplicação, contendo informações necessárias para poder atuar como comprador. Toda loja também será um user, por isso há a definição do role, diferenciando lojas e apenas usuários compradores. Ao ser criado, o usuário é do tipo CLIENT, ativo e não verificado.

Colunas:

3.2. Tabela address

Armazena informações referentes ao endereços cadastrados. Está equipada para receber endereços completos, inclusive com bairro, cidade, estado e país.

Colunas:

Relacionamentos:

• fk_user: Relacionamento N:1 com a tabela user (address.fk_user -> user.id_user): cada endereço pertence a um usuário.

3.3. Tabela store

Armazena informações da loja. Como a loja também será um possível usuário comprador, essa tabela é tratada como "extensão" da tabela user.

Colunas:

Relacionamentos:

• Relacionamento 1:1 com tabela de usuário, replicando o ID, e agindo como uma extensão da tabela.
• Relacionamento 1:1 com tabela de endereços, registrando, opcionalmente, o endereço da loja física, para exibição no mapa.

3.4. Tabela store_photo

Armazena as informações referentes à galeria de uma loja, inclusive as posições para manter o posicionamento desejado. Não contém a foto de perfil.

Colunas:

Relacionamentos:

• fk_store: Relacionamento N:1 com a tabela store (store_photo.fk_store -> store.id_store).

3.5. Tabela metrics

Armazena as métricas diárias de uma loja, com um registro para cada par loja-dia.

Colunas:

Relacionamentos:

• id_store: Relacionamento N:1 com a tabela store (metrics.id_store -> store.id_store).
• UNIQUE(id_store, date): O par loja-dia na tabela de métricas deve ser único.

3.6. Tabela category

Armazena as categorias de produto (Eletrônico, Roupas, Etc.). Será carregada com valores pré-determinados, não recebendo inserções do usuário.

Colunas:

Relacionamentos:

• É um 'guarda-chuva' de produtos.

3.7. Tabela product

Armazena as informações gerais do produto, sem ter as informações pertinentes apenas à cada variação.

Colunas:

Relacionamentos:

• id_store: Relacionamento N:1 com a tabela store (product.id_store -> store.id_store).

3.8. Tabela product_photo

Armazena N fotos para um produto.

Colunas:

Relacionamentos:

• id_product: Relacionamento N:1 com a tabela product (product_photo.id_product -> product.id_product).

3.9. Tabela product_category (Tabela Intermediária)

Armazena os relacionamentos categoria-produto, já que estes tem uma relação N:N. Na modelagem do banco, ele foi preparado para um produto ter várias categorias e uma categoria ter vários produtos.

Colunas:

Relacionamentos:

• fk_product: Relacionamento N:1 com a tabela product (product_category.fk_product -> product.id_product).
• fk_category: Relacionamento N:1 com a tabela category (product_category.fk_category -> category.id_category).

3.10. Tabela variant_category

Armazena as características de um produto, como Cor, Tamanho, Tecido, etc. Aqui é guardado um valor digitado pelo usuário e cada uma é relacionada apenas ao produto específico.

Colunas:

Relacionamentos:

• Referencia o ID do produto variant_category_product.

3.11. Tabela variant_option

Armazena as opções para cada característica (variant_category) de um produto, como Cores (vermelho, azul), tamanho (P, M, G, 41, 42) etc.

Colunas:

Relacionamentos:

• Referencia o ID da característica id_variant_category.

3.12. Tabela product_variant

Armazena cada uma das variantes do produto. Cada produto deve ter ao menos uma variante, para ter indicação de preço e estoque. Tem um campo details que armazena uma string concatenada de uma opção para cada característica. A concatenação dos valores da variantes é verificada no backend e estruturada de forma que, para cada característica do produto, haja um valor de opção na string concatenada, ordenada por valor crescente de id_variant_category.

Colunas:

Relacionamentos:

• fk_product: Relacionamento Muitos-para-Um com a tabela product (product_variant.fk_product -> product.id_product).

3.13. Tabela sponsor

Armazena as informações dos patrocinadores do Coopera-RS.

Colunas:

Relacionamentos:

• Nenhum

3.14. Tabela order

Armazena as ordens do marketplace.

Colunas:

Relacionamentos:

• fk_user: Relacionamento N:1 com a tabela user.
• fk_store: Relacionamento N:1 com a tabela store.
• fk_address: Relacionamento N:1 com a tabela address.

3.15. Tabela order_item

Armazena cada item de uma ordem, com referência para o item, a ordem e a quantidade.

Colunas:

Relacionamentos:

• fk_order: Relacionamento N:1 com a tabela order.
• fk_product_variant: Relacionamento N:1 com a tabela product_variant.

3.16. Tabela evaluation

Armazena todas as informações pertinentes ao sistema de avaliações.

Colunas:

Relacionamentos:

• fk_order: Relacionamento 1:1 com a tabela order.

Modelo não-relacional utilizando Redis

Para a implementação do carrinho, devido à sua alta volatilidade e frequentes operações de sobrescrever e deletar informações, optou-se por integrar um modelo não relacional. Cada carrinho irá conter informações do usuário dono do carrinho e da loja, bem como uma lista de itens, como mostra o exemplo abaixo:

{
	"id_user": 17,
	"id_store": 3,
	"items": [
		{
			"id": 9,
			"storeID": 3,
			"name": "Produto 1",
			"description": "Produto teste",
			"photos": [
				"https://example.com/photo.jpg"
			],
			"category": [
				{
					"id": 1,
					"name": "Roupas"
				}
			],
			"variant": {
				"price": 10,
				"stock": 1,
				"options": {
					"Cor": "Vermelho",
					"Tamanho": "M"
				}
			},
			"quantity": 5,
			"lastUpdated": "2025-06-16T17:28:04.576495"
		}
	]
}