GeoLens

Aplicação web para gerenciamento de cidades, países e continentes, construída com React, TypeScript, Express, Prisma e PostgreSQL.
Permite cadastro, edição, remoção e visualização de dados com interface moderna, responsiva e suporte a tema claro/escuro.

---

Tecnologias

• Frontend: React, TypeScript, Vite, CSS Modules
• Backend: Node.js, TypeScript, Express, Prisma
• Banco de dados: PostgreSQL
• Design & UX: Gradientes, temas dinâmicos, CSS Variables

---

APIs Externas

O GeoLens utiliza as seguintes APIs para obter informações geográficas e meteorológicas:

• OpenMeteo – API de previsão do tempo para cidades
• OpenMeteo Geocoding – API de geocodificação de cidades
• REST Countries – API para informações sobre países, idiomas e moedas

---

Funcionalidades

• CRUD completo de cidades, países e continentes
• Pesquisa e filtros
• Tema claro e escuro alternável
• Preenchimento automático de dados utilizando APIs externas

---

Requisitos

• Node.js => 22.15
• npm => 10.9
• PostgreSQL = 16
• Navegador moderno (Chrome, Edge, Firefox)

---

Rodando o Backend

1. Criar o banco de dados PostgreSQL

Linux:

psql -U postgres
CREATE DATABASE geolens;
\q

Windows:

psql -U postgres
CREATE DATABASE geolens;
\q

Substitua postgres pelo usuário do seu PostgreSQL, se necessário.

2. Configurar a variável de ambiente DATABASE_URL

Linux:

export DATABASE_URL="postgresql://usuario:senha@localhost:5432/geolens"

Windows:

$env:DATABASE_URL="postgresql://usuario:senha@localhost:5432/geolens"

3. Instalar dependências do backend

cd backend
npm install

4. Aplicar as migrações do Prisma

npx prisma db push

Cria todas as tabelas definidas no schema do Prisma no banco de dados.

5. Rodar o backend

npm run dev

Servidor rodando em http://localhost:3000.

Rodando o Frontend

1. Instalar dependências

cd frontend
npm install

2. Rodar o frontend

npm run dev

Frontend disponível em http://localhost:5173 (Vite).

Autor

Desenvolvido por Ygor Ruan Pereira - LinkedIn | GitHub