Skip to content

Latest commit

 

History

History
152 lines (113 loc) · 4.11 KB

README.md

File metadata and controls

152 lines (113 loc) · 4.11 KB

AutêntikA

Aplicação Java Spring Boot com integração ao MongoDB para autenticação de usuários e gerenciamento de endereços. Frontend estático em src/main/resources/static consumindo a API em http://localhost:8080/api.

Pré-requisitos

  • Java 17 ou superior
  • Maven 3.6 ou superior
  • MongoDB instalado e rodando (padrão: localhost:27017)

Configuração

1. Instalar e iniciar o MongoDB

Certifique-se de que o MongoDB está instalado e rodando na porta padrão (27017).

Windows:

# Inicie o MongoDB (se instalado como serviço, já estará rodando)
# Ou execute manualmente:
mongod

Linux/Mac:

sudo systemctl start mongod
# ou
mongod

2. Configurar a conexão do MongoDB

O arquivo src/main/resources/application.properties já está configurado para:

  • Host: localhost
  • Porta: 27017
  • Database: autentika

Se necessário, altere essas configurações no arquivo application.properties.

Como executar

1. Compilar o projeto

mvn clean install

2. Executar a aplicação

mvn spring-boot:run

Ou execute a classe AutentikaApplication.java diretamente no seu IDE.

A aplicação estará disponível em: http://localhost:8080

Endpoints da API

Autenticação

  • POST /api/auth/cadastro
  • POST /api/auth/login

Endereços

  • POST /api/enderecos
  • GET /api/enderecos/usuario/{usuarioId}
  • GET /api/enderecos/{id}
  • PUT /api/enderecos/{id}
  • DELETE /api/enderecos/{id}

Frontend

As páginas HTML em src/main/resources/static estão configuradas para consumir a API em http://localhost:8080/api.

Para testar o frontend

  • Abra os arquivos index.html, login.html, cadastro.html, perfil.html e endereco.html
  • Garanta que o servidor Spring Boot está ativo na porta configurada (8080 por padrão)
  • Se abrir via file://, ative um servidor estático local para evitar restrições de CORS

Estrutura do Projeto

autentika/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── org/example/
│   │   │       ├── AutentikaApplication.java
│   │   │       ├── config/
│   │   │       │   └── CorsConfig.java
│   │   │       ├── controller/
│   │   │       │   ├── AuthController.java
│   │   │       │   └── EnderecoController.java
│   │   │       ├── model/
│   │   │       │   ├── Usuario.java
│   │   │       │   └── Endereco.java
│   │   │       ├── repository/
│   │   │       │   ├── UsuarioRepository.java
│   │   │       │   └── EnderecoRepository.java
│   │   │       └── service/
│   │   │           └── UsuarioService.java
│   │   └── resources/
│   │       ├── application.properties
│   │       └── static/
│   │           ├── index.html
│   │           ├── login.html
│   │           ├── cadastro.html
│   │           ├── perfil.html
│   │           ├── endereco.html
│   │           ├── js/
│   │           └── css/
│   └── test/
└── pom.xml

Testes

Executar testes

mvn test

Os testes de integração validam a conexão com o MongoDB e as operações das APIs principais.

Segurança

  • As senhas são criptografadas usando BCrypt antes de serem salvas no banco de dados
  • A senha nunca é retornada nas respostas da API
  • Validações de email e senha são realizadas tanto no frontend quanto no backend

Troubleshooting

Erro de conexão com MongoDB

  • Verifique se o MongoDB está rodando: mongosh ou mongo
  • Verifique a porta e host no application.properties

Erro de CORS

  • O CORS já está configurado para permitir todas as origens
  • Se ainda houver problemas, verifique a configuração em CorsConfig.java

Porta 8080 já em uso

  • Altere a porta no application.properties: server.port=8081
  • Atualize as URLs nas páginas HTML também

Desenvolvido com

  • Spring Boot 3.2.0
  • Spring Data MongoDB
  • BCrypt para hash de senhas
  • MongoDB