Skip to content

GitLab

Last edited by William De Oliveira Klein
Page history
This is an old version of this page. You can view the most recent version or browse the history.

banco_dados

Banco de Dados WeConecta – PostgreSQL

O projeto WeConecta utiliza o PostgreSQL como sistema gerenciador de banco de dados.
A escolha se deve à sua robustez, forte consistência transacional (ACID), suporte nativo a JSON, integrações seguras e bom desempenho em modelagens relacionais com uso de JSON.

Modelo Conceitual

Criado utilizando o software brModelo:

Modelo Lógico

Modelado utilizando o dbdiagram.io:

Estrutura das Tabelas

A seguir estão as tabelas e descrições detalhadas do banco de dados.

➤ Tabela: users

Armazena todos os usuários do sistema.

Coluna Tipo Restrições Descrição
id uuid PK Identificador único.
email varchar(255) UNIQUE, NOT NULL E-mail de acesso.
password varchar(255) NOT NULL Hash da senha.
phone varchar(11) UNIQUE, NULLABLE Telefone do usuário.
friendly_name varchar(255) NULLABLE Nome de exibição.
role enum(UserRole) NOT NULL Permissão (ADMIN ou MEMBER).
blocked_at timestamp NULLABLE Data/hora de bloqueio.
first_login boolean NOT NULL, DEFAULT: true Indica se é o primeiro acesso.
created_at timestamp NOT NULL, DEFAULT: CURRENT_TIMESTAMP Data de criação.

Relacionamentos:

  • 1:N com surveys (usuário criador).
  • 1:N com survey_answers (como client_id).
  • N:N com surveys via users_surveys.

➤ Tabela: surveys

Representa um questionário cadastrado no sistema.

Coluna Tipo Restrições Descrição
id integer PK Identificador único do questionário.
first_survey_element integer FK → survey_elements, NULLABLE Primeiro elemento do fluxo.
title varchar(255) NOT NULL Título.
description varchar(500) NULLABLE Descrição.
url varchar(255) NULLABLE URL pública.
flow jsonb NULLABLE Estrutura de fluxo.
is_published boolean NOT NULL, DEFAULT: false Status de publicação.
user_id uuid FK → users, NOT NULL Criador (owner).
created_at timestamp NOT NULL, DEFAULT: CURRENT_TIMESTAMP Criação.
updated_at timestamp NOT NULL, DEFAULT: CURRENT_TIMESTAMP Última alteração.

Relacionamentos:

  • N:1 com users (owner).
  • 1:N com survey_answers.
  • 1:N com users_surveys.
  • N:1 com survey_elements via first_survey_element.

➤ Tabela: users_surveys

Tabela que representa o relacionamento N:N entre usuários e questionários (usuários colaboradores).

Coluna Tipo Restrições Descrição
id integer PK Identificador único.
user_id uuid FK → users, NOT NULL Usuário colaborador.
survey_id integer FK → surveys, NOT NULL Questionário associado.

Relacionamentos:

  • N:1 com users.
  • N:1 com surveys.

➤ Tabela: survey_elements

Representa um elemento do questionário (pergunta, mensagem, input, múltipla escolha).

Coluna Tipo Restrições Descrição
id integer PK Identificador do elemento.
description varchar(500) NOT NULL Enunciado/texto do elemento.
type enum(SurveyElementType) NOT NULL Tipo do elemento.
deleted_at timestamp NULLABLE Soft delete.

Relacionamentos:

  • 1:N com options.
  • 1:N com survey_answers.
  • 1:N com surveys como elemento inicial.

➤ Tabela: options

Opções associadas a um elemento do questionário.

Coluna Tipo Restrições Descrição
id integer PK Identificador da opção.
survey_element_id integer FK → survey_elements, NOT NULL Elemento ao qual pertence.
description varchar(255) NOT NULL Texto da opção.
deleted_at timestamp NULLABLE Soft delete.

Relacionamentos:

  • N:1 com survey_elements.
  • 1:N com survey_answers.

➤ Tabela: survey_answers

Armazena as respostas fornecidas pelos participantes.
Cada registro representa uma opção marcada ou uma resposta de input.

Chave Primária Composta:

  • identifier
  • client_id
  • survey_id
  • survey_element_id
  • option_id
Coluna Tipo Restrições Descrição
identifier varchar PK Identificador do respondente.
client_id uuid PK, FK → users Usuário membro que gerou o link.
survey_id integer PK, FK → surveys Survey respondido.
survey_element_id integer PK, FK → survey_elements Elemento respondido.
option_id integer PK, FK → options Opção marcada.
input_response varchar NULLABLE Resposta textual (para perguntas de input).
created_at timestamp NOT NULL, DEFAULT: CURRENT_TIMESTAMP Criação.
updated_at timestamp NOT NULL, DEFAULT: CURRENT_TIMESTAMP Última alteração.

Observações importantes:

  • Perguntas MULTIPLE_CHOICE geram várias linhas com o mesmo identifier + client_id + survey_id + survey_element_id, variando apenas o option_id.
  • client_id garante segregação das respostas por usuário que distribuiu o link.