https://github.com/jxhnlcs/fullstack_consultacep
Sistema onde o usuário digita um CEP e o app retorna os dados do endereço (logradouro, cidade, estado, etc.) usando uma API externa (ViaCEP).
https://github.com/jxhnlcs/fullstack_consultacep
angular java springboot typescript viacep
Last synced: 5 months ago
JSON representation
Sistema onde o usuário digita um CEP e o app retorna os dados do endereço (logradouro, cidade, estado, etc.) usando uma API externa (ViaCEP).
- Host: GitHub
- URL: https://github.com/jxhnlcs/fullstack_consultacep
- Owner: jxhnlcs
- Created: 2025-03-22T04:54:58.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-22T05:30:10.000Z (over 1 year ago)
- Last Synced: 2025-06-25T22:07:40.963Z (about 1 year ago)
- Topics: angular, java, springboot, typescript, viacep
- Language: TypeScript
- Homepage:
- Size: 147 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 📍 Consulta de Endereço por CEP
Aplicação web moderna para consultar informações de endereço a partir do CEP, utilizando:
- ✅ Backend em Spring Boot com consumo da API ViaCEP
- ✅ Frontend em Angular com Tailwind CSS e Font Awesome
- ✅ Interface clean, responsiva e com layout minimalista
---
## 💻 Tecnologias Utilizadas
### 🔹 Backend
- Java 17
- Spring Boot 3
- Spring Web
- API pública ViaCEP
### 🔹 Frontend
- Angular 18
- Tailwind CSS
- Font Awesome
- HTML/CSS moderno e responsivo
---
## 🧠 Funcionalidades
- Buscar endereço por CEP
- Exibir:
- Logradouro
- Bairro
- Cidade
- Estado
- CEP
- DDD
- Layout responsivo com ícones e cores suaves
- Feedback de erro para CEP inválido
---
## 🚀 Como Rodar o Projeto
### 📦 Backend
1. Navegue até a pasta do backend:
- `cd cepapi`
2. Execute a aplicação:
- `./mvnw spring-boot:run`
3. Acesse:
- `http://localhost:8080/api/cep/{cep}`
---
### 💻 Frontend
1. Navegue até a pasta do frontend:
- `cd cepweb`
2. Instale as dependências:
- `npm install`
3. Inicie o servidor:
- `ng serve`
4. Acesse:
- `http://localhost:4200`
## 📌 Observações
Este projeto foi desenvolvido com foco em visual limpo, uso de APIs públicas e boas práticas de consumo de dados assíncronos com Angular + Spring Boot.