Front perfil

.gitignore

@@ -36,4 +36,20 @@ cypress/downloads
 .env.testing
 .env.development
 .env.staging
-.env.production
+.env.production
+
+# Ambiente virtual
+venv/
+.env/
+
+# Arquivos de compilação
+_pychache_/
+*.pyc
+*.pyo
+
+# Vscode config
+.vscode/
+.idea/
+
+# Logs
+*.temp

README.md

@@ -1,3 +1,9 @@
+# 🚀 Guia de Integração do Frontend
+
+Este guia explica como configurar, estruturar e integrar o frontend do projeto React com o backend Flask.
+
+---
+
 # ESS Front-end React
 
 This is the Front-end base project in React for the Software and Systems Engineering discipline, offered by the Informatics Center (CIn) of the Federal University of Pernambuco (UFPE).
@@ -27,6 +33,9 @@ Clone the repository and install the dependencies by running the following comma
 
 ```
 npm install
+npm install react-bootstrap bootstrap
+npm install react-icons --save
+
 ```
 
 ### First time running ?
@@ -46,6 +55,26 @@ npm run
 
 This project uses `.env` files to manage environment variables. You can create a `.env.development` file in the project directory and set the environment variables in the file (iou can create it from .`env.example`). The `env` script in the `package.json` file uses the `env-cmd` package to load the environment variables from the `.env.development` file.
 
+Crie um arquivo .env na raiz do frontend e adicione a URL da API:
+```
+VITE_API_URL=http://127.0.0.1:5000
+```
+
+📂 src/ → Código-fonte do projeto │
+├── 📂 app/ → Páginas principais (leva a estilização das telas) │ ├── 📂 home/ │ │ ├── 📂 pages/ │ │ │ ├── Login.tsx → Tela de Login │ │ │ ├── Cadastro.tsx → Tela de Cadastro │ │ │ ├── Reservas.tsx → Tela após login │
+├── 📂 shared/ → Recursos compartilhados │ ├── 📂 services/ → Serviços de integração com a API │ │ ├── autorizacao.tsx → Requisições de login/cadastro │
+├── App.tsx → Arquivo principal do React onde você adiciona suas rotas criadas nas pages! ├── main.tsx → Ponto de entrada da aplicação │ ├── .env → Configuração da API ├── package.json → Lista de dependências ├── README.md → Você está aqui! 📌
+
+Endereço para se colocar as estilizações próprias de cada tela.
+```
+src\app\home\styles
+```
+
+Endereço onde se pode colocar arquivos css em comum ao sistema
+```
+src\shared\components
+```
+
 ### Running the App
 
 To start the app, run the following command:
@@ -56,6 +85,78 @@ npm run dev
 
 This command will run the React app in development with Vite.js script
 
+
+
+## Rodando  o backend Flask
+
+No powerShell mude para o diretório backend
+```
+cd backend
+```
+Crie arquivos __init__.py em todos diretórios dentro de backend, inclusive nele.
+
+backend/
+   __init__.py
+   main.py
+   testes/
+      __init__.py
+      teste_exemplo.py
+
+MacOS
+Dentro da pasta backend no terminal, execute os seguintes comandos:
+
+```
+export PYTHONPATH=$(pwd)/backend
+export FLASK_APP=main
+flask run
+```
+
+Dentro da pasta backend/testes, execute:
+
+```
+export PYTHONPATH=$(pwd)/backend
+pytest
+Windows (Powershell)
+```
+Dentro da pasta backend no PowerShell, execute os seguintes comandos:
+
+```
+$env:PYTHONPATH = "$(pwd)/backend"
+$env:FLASK_APP = "main"
+flask run
+```
+
+
+Crie a venv
+```
+python -m venv venv
+```
+Ative a venv
+```
+Para windows:
+venv\Scripts\activate
+
+Para MacOS:
+source venv/bin/activate
+
+```
+e agora você deve instalar todas as dependencias do projeto 
+
+```
+pip install -r requirements.txt
+```
+
+obs: caso sejam necessárias novas bibliotecas e deseja atualizar o requirements.txt por favor recirar arquivo.
+```
+pip freeze > requirements.txt
+```
+
+Rodando servidor Flask localmente na rota 5000.
+```
+python main.py
+```
+
+
 ## Running the tests
 
 There are two types of tests configured in the base project: unit tests using Vitest with React Testing Library and E2E acceptance tests using Cypress with Cucumber. It's interesting to create the **.env.testing** at the root of the project the same way it was created to run in development, changing the necessary values.

backend/blueprints.py

@@ -0,0 +1,85 @@
+from flask import Flask, jsonify  # Adicionei jsonify aqui
+from backend.rotas.login import login_bp
+from backend.rotas.cadastro import cadastro_bp
+from backend.rotas.logout import logout_bp
+from backend.rotas.criar_solicitacao_manutencao import criar_manutencao_bp
+from backend.rotas.criar_solicitacao_recursos import criar_recursos_bp
+from backend.rotas.excluir_solicitacao_manutencao import excluir_manutencao_bp
+from backend.rotas.excluir_solicitacao_recursos import excluir_recursos_bp
+from backend.rotas.editar_solicitacao_manutencao import editar_manutencao_bp
+from backend.rotas.editar_solicitacao_recursos import editar_recursos_bp
+from backend.rotas.reservas import reservas_bp
+from backend.rotas.salas import salas_bp
+from backend.rotas.usuario import usuarios_bp
+from backend.rotas.criarReview import criar_review_bp
+from backend.rotas.atualizarReview import atualizar_review_bp
+from backend.rotas.deletarReview import deletar_review_bp
+from backend.rotas.obterReview import obter_review_bp
+from backend.rotas.listarReview import listar_reviews_bp
+from backend.rotas.perfil import perfil_bp 
+from backend.rotas.reservas_ativas import reservas_ativas_bp
+from backend.rotas.exclusao_perfil import exclusao_perfil_bp
+from backend.rotas.atualizar_perfil import atualizar_perfil_bp 
+from backend.rotas.historico_reserva import historico_reservas_bp
+from flask_cors import CORS
+
+def registrarBlueprints(app):
+    blueprints = [
+        perfil_bp,         
+        exclusao_perfil_bp, 
+        atualizar_perfil_bp,
+        historico_reservas_bp,
+        login_bp,
+        cadastro_bp,
+        logout_bp,
+        criar_manutencao_bp,
+        criar_recursos_bp,
+        excluir_manutencao_bp,
+        excluir_recursos_bp,
+        editar_recursos_bp,
+        editar_manutencao_bp,
+        salas_bp,
+        usuarios_bp,
+        reservas_bp,
+        criar_review_bp,
+        listar_reviews_bp,
+        obter_review_bp,
+        deletar_review_bp,
+        atualizar_review_bp,
+        reservas_ativas_bp
+    ]
+
+    # Configuração global do CORS
+    CORS(app, 
+         supports_credentials=True,
+         resources={
+             r"/api/*": {
+                 "origins": "*",
+                 "methods": ["GET", "POST", "PUT", "DELETE", "OPTIONS"],
+                 "allow_headers": ["Content-Type", "Authorization"]
+             }
+         })
+
+    # Registra os blueprints
+    for blueprint in blueprints:
+        app.register_blueprint(blueprint)
+
+    @app.after_request
+    def add_cors_headers(response):
+        response.headers["Access-Control-Allow-Origin"] = "*"
+        response.headers["Access-Control-Allow-Methods"] = "GET, POST, PUT, DELETE, OPTIONS"
+        response.headers["Access-Control-Allow-Headers"] = "Content-Type, Authorization"
+        response.headers["Access-Control-Allow-Credentials"] = "true"
+        return response
+
+    # Debug route to list all endpoints
+    @app.route("/routes")
+    def list_routes():
+        routes = []
+        for rule in app.url_map.iter_rules():
+            routes.append({
+                "endpoint": rule.endpoint,
+                "methods": list(rule.methods),
+                "path": str(rule)
+            })
+        return jsonify(routes)

backend/config.py

@@ -0,0 +1,7 @@
+import os
+
+class Config:
+    SECRET_KEY = os.urandom(24)
+    SQLALCHEMY_DATABASE_URI = "sqlite:///users.db"
+    SQLALCHEMY_TRACK_MODIFICATIONS = False
+

backend/features/atualizarReview.feature

@@ -0,0 +1,13 @@
+Feature: Atualizar avaliação
+
+  Scenario: Atualizar uma avaliação existente
+    Given o professor Suruagy deseja editar uma avaliação feita anteriormente
+    When ele envia uma requisição PUT "/api/reviews/1" especificando o id "1" da avaliação que deseja editar
+    And modifica a nota de "4" para "5" e o comentário de "Sala boa, mas com algumas falhas." para "Modificações feitas, a sala está impecável agora!"
+    Then o sistema retorna a mensagem "Avaliação atualizada com sucesso." e o status 200 OK
+
+  Scenario: Tentar atualizar uma avaliação que não existe
+    Given o professor Suruagy deseja editar uma avaliação cuja qual não está presente no sistema
+    When ele envia uma requisição PUT "/api/reviews/1" especificando o id "1" da avaliação que deseja editar
+    And modifica a nota de "4" para "5" e o comentário de "Sala boa, mas com algumas falhas." para "Falhas corrigidas, a sala está impecável!"
+    Then o sistema retorna a mensagem "Avaliação não encontrada para o ID fornecido." e o status 404 NOT FOUND

backend/features/cadastroServico.feature

@@ -0,0 +1,100 @@
+Feature: Serviço de Cadastro de Usuários
+
+  Scenario: Sucesso no cadastro de usuário
+    Given o usuário deseja se cadastrar
+    When ele informa o nome "Demosténes"
+    And ele informa o CPF "126.455.789-00"
+    And ele informa o email "demostenessouza@example.com"
+    And ele informa se é professor "N"
+    And ele informa a senha "SecurePassword123"
+    And ele informa a confirmação da senha "SecurePassword123"
+    And ele envia uma requisição POST para "/cadastro"
+    Then a resposta deve conter a mensagem "Cadastro criado com sucesso!"
+    And o status code deve ser "201"
+
+  Scenario: Sucesso no cadastro de professor
+    Given o usuário deseja se cadastrar
+    When ele informa o nome "Tatiana"
+    And ele informa o CPF "331.879.789-33"
+    And ele informa o email "vanessasilva@example.com"
+    And ele informa se é professor "S"
+    And ele informa o SIAPE "101110"
+    And ele informa a senha "12345678"
+    And ele informa a confirmação da senha "12345678"
+    And ele envia uma requisição POST para "/cadastro"
+    Then a resposta deve conter a mensagem "Cadastro criado com sucesso!"
+    And o status code deve ser "201"
+
+  Scenario: Fracasso no cadastro por campos obrigatórios não preenchidos
+    Given o usuário deseja se cadastrar
+    When ele informa o nome "João"
+    And ele informa o CPF "987.654.321-00"
+    And ele informa o email "joao@iat.com"
+    And ele informa se é professor "N"
+    And ele informa a senha "Password123"
+    And ele deixa o campo "Confirmar Senha" com ""
+    And ele envia uma requisição POST para "/cadastro"
+    Then a resposta deve conter a mensagem "Confirmar Senha é obrigatório."
+    And o status code deve ser "400"
+
+  Scenario: Fracasso no cadastro por duplicação de ID única
+    Given o usuário deseja se cadastrar
+    When ele informa o nome "Carlos Mendes"
+    And ele informa o CPF "126.456.789-00"
+    And ele informa o email "demostenes@example.com"
+    And ele informa se é professor "S"
+    And ele informa o SIAPE "010101"
+    And ele informa a senha "Password456"
+    And ele informa a confirmação da senha "Password456"
+    And ele envia uma requisição POST para "/cadastro"
+    Then a resposta deve conter a mensagem "Erro: email/cpf já está registrado."
+    And o status code deve ser "409"
+
+  Scenario: Fracasso no cadastro por senhas que não coincidem
+    Given o usuário deseja se cadastrar
+    When ele informa o nome "Beatriz"
+    And ele informa o CPF "789.456.123-00"
+    And ele informa o email "Beatriz.oliveira@example.com"
+    And ele informa se é professor "N"
+    And ele informa a senha "MyPassword123"
+    And ele informa a confirmação da senha "DifferentPassword123"
+    And ele envia uma requisição POST para "/cadastro"
+    Then a resposta deve conter a mensagem "As senhas não coincidem."
+    And o status code deve ser "400"
+
+    Scenario: Fracasso no cadastro por formato inválido de email
+    Given o usuário deseja se cadastrar
+    When ele informa o nome "Lucas"
+    And ele informa o CPF "987.654.321-00"
+    And ele informa o email "lucas.example.com"
+    And ele informa se é professor "N"
+    And ele informa a senha "SenhaForte123"
+    And ele informa a confirmação da senha "SenhaForte123"
+    And ele envia uma requisição POST para "/cadastro"
+    Then a resposta deve conter a mensagem "Formato de email inválido. Use um email válido, como exemplo@dominio.com."
+    And o status code deve ser "400"
+
+  Scenario: Fracasso no cadastro por formato inválido de CPF
+    Given o usuário deseja se cadastrar
+    When ele informa o nome "Fabricio"
+    And ele informa o CPF "123"
+    And ele informa o email "fabricio@example.com"
+    And ele informa se é professor "N"
+    And ele informa a senha "SenhaSegura456"
+    And ele informa a confirmação da senha "SenhaSegura456"
+    And ele envia uma requisição POST para "/cadastro"
+    Then a resposta deve conter a mensagem "CPF inválido. Digite um CPF válido no formato XXX.XXX.XXX-XX."
+    And o status code deve ser "400"
+
+  Scenario: Fracasso no cadastro por siape já registrado
+    Given o usuário deseja se cadastrar
+    When ele informa o nome "Max"
+    And ele informa o CPF "987.654.321-00"
+    And ele informa o email "max@gmail.com"
+    And ele informa se é professor "S"
+    And ele informa o SIAPE "101010"
+    And ele informa a senha "Senha123"
+    And ele informa a confirmação da senha "Senha123"
+    And ele envia uma requisição POST para "/cadastro"
+    Then a resposta deve conter a mensagem "Erro: siape já está registrado."
+    And o status code deve ser "409"

backend/features/criarReview.feature

@@ -0,0 +1,26 @@
+Feature: Criação de Review
+
+  Scenario: Criação bem-sucedida de review
+    Given que o professor Suruagy deseja fazer uma avaliação pós reserva com reserva_id "1" para a sala_id "2"
+    When ele envia uma requisição POST para "/api/reviews" com os dados reserva_id "1", sala_id "2", usuario_id "3", nota "4" e comentário "Sala boa, mas com algumas falhas."
+    Then o sistema retorna "Avaliação criada com sucesso!" com o status 201
+
+  Scenario: Falha ao criar review sem nota
+    Given que o professor Suruagy deseja fazer uma avaliação pós reserva com reserva_id "1" para a sala_id "2"
+    When ele envia uma requisição POST para "/api/reviews" com os dados reserva_id "1", sala_id "2", usuario_id "3", nota "" e comentário "Sala boa, mas sem computador!"
+    Then o sistema retorna "A nota é obrigatória para avaliar a sala." com o status 400
+
+  Scenario: Falha ao criar review sem sala_id
+    Given que o professor Suruagy deseja fazer uma avaliação pós reserva com reserva_id "1" para a sala_id ""
+    When ele envia uma requisição POST para "/api/reviews" com os dados reserva_id "1", sala_id "", usuario_id "3", nota "4" e comentário "Sala boa, mas sem computador!"
+    Then o sistema retorna "O ID da Sala é obrigatório para avaliar a sala." com o status 400
+
+  Scenario: Falha ao criar review sem usuario_id
+    Given que o professor Suruagy deseja fazer uma avaliação pós reserva com reserva_id "1" para a sala_id "2"
+    When ele envia uma requisição POST para "/api/reviews" com os dados reserva_id "1", sala_id "2", usuario_id "", nota "4" e comentário "Sala boa, mas sem computador!"
+    Then o sistema retorna "O ID do Usuário é obrigatório para avaliar a sala." com o status 400
+
+  Scenario: Falha ao criar review sem reserva_id
+    Given que o professor Suruagy deseja fazer uma avaliação pós reserva com reserva_id ""
+    When ele envia uma requisição POST para "/api/reviews" com os dados reserva_id "", sala_id "2", usuario_id "3", nota "4" e comentário "Sala boa, mas sem computador!"
+    Then o sistema retorna "O ID da Reserva é obrigatório para avaliar a sala." com o status 400