2025.2 Valhalla — Guardiões da Universidade

Sobre

O Guardiões da Universidade, desenvolvido pelo grupo Valhalla no 2° semestre de 2025 na disciplina Métodos de Desenvolvimento de Software, tem como objetivo oferecer um canal de denúncias e orientação para a comunidade acadêmica da Universidade de Brasília (UnB).
A plataforma permite que alunos e servidores relatem situações, conheçam os procedimentos oficiais e acompanhem informações sobre demandas da universidade.

⚠️ Observação Importante

Por questões legais, a UnB não pode receber denúncias por plataformas não oficiais regulamentadas pelo Governo Federal.
Dessa forma, o Guardiões da Universidade não registra denúncias oficialmente, atuando apenas como um meio de apoio e desburocratização. Esse também foi o motivo da escolha do nome do projeto.

---

---

Tecnologias Utilizadas

• Front-end: React, TypeScript, TailwindCSS
• Back-end: Node.js, TypeScript
• Banco de Dados: PostgreSQL, ORM Prisma
• Outras Ferramentas: Jest

---

Instalação

Para rodar o projeto localmente, siga os passos abaixo:

1. Clone o repositório:

   git clone https://github.com/fga-eps-mds/2025.2-Valhalla.git

2. Navegue até o diretório do projeto:

   cd 2025.2-Valhalla

3. Instale as dependências do Front-end:

   cd Front
   npm install

4. Instale as dependências do Back-end:

   cd ../Back
   npm install

5. Configure as variáveis de ambiente: Crie um arquivo .env na pasta Back e adicione as seguintes variáveis:

   DATABASE_URL="postgresql://user:password@host:port/database"
   JWT_SECRET="your_jwt_secret"
   

   Substitua user, password, host, port e database pelas suas credenciais do PostgreSQL. your_jwt_secret deve ser uma string segura e aleatória.

6. Execute as migrações do banco de dados:

   cd Back
   npx prisma migrate dev --name init

7. Inicie o Back-end:

   npm run start
   ou
   npm run start:dev

8. Inicie o Front-end: Abra um novo terminal, navegue até a pasta Front e execute:

   npm run dev

O aplicativo estará disponível em http://localhost:3000 (ou outra porta, dependendo da configuração do seu ambiente).

---

Testes

O backend utiliza Jest para a execução de testes automatizados, garantindo a qualidade e confiabilidade do código. Para rodar os testes no projeto, siga os passos abaixo:

1. Navegue ao diretório do projeto

   cd ../back

2. Execução dos testes

   # Executa todos os testes
   npm run test
   
   # Executa os testes em modo watch
   npm run test:watch
   
   # Gera relatório de cobertura de testes
   npm run test:cov

3. Relatório em csv Gera um relatório na pasta ../back/coverage/planilha-cobertura.csv

   # Geração do relatório de testes em .csv
   node gerar-csv.js

---

Equipe de Desenvolvimento

Antonio Lucas 241025597	Gabriel Diniz 241025630	Gustavo Bonifácio 241025659	Julia Gabriella 241036142	Laura Rogelin 222006928
Lucas Alves 241025541	Lucas Oliveira 241011386	Pedro Henrique 241025980	Pedro Ian 241025837	Pedro Lucas 241025710