GeoNexus: O mundo conectado de forma clara e acolhedora

Um sistema web construído com o propósito de gerenciar dados relacionados a cidades, países e continentes, integrando informações reais de APIs externas em uma interface pastel e acolhedora.

---

---

🌍 Sobre o Projeto | ⭐ Funcionalidades | 💻 Tecnologias | 🧩 APIs | 💡 Como Executar | 🗂 Estrutura |
💌 Créditos

---

🌍 Sobre o Projeto

O GeoNexus é uma aplicação acadêmica desenvolvida para gerenciar dados geográficos através de CRUDs completos. Com ele, é possível relacionar:

➡ Continentes → Países → Cidades

A interface foi projetada com tons pastéis, predominantemente rosa, trazendo suavidade, clareza e acessibilidade. Além disso, o sistema integra duas APIs externas para enriquecer os dados com bandeiras, informações detalhadas e notícias em tempo real.

---

⭐ Funcionalidades

🌎 Continentes

✔ Criar ✔ Listar ✔ Atualizar ✔ Excluir

🇧🇷 Países

✔ Associados a um continente ✔ CRUD completo ✔ Listar países por continente ✔ Exibir dados extras via REST Countries ✔ Exibir notícias via NewsData

🏙️ Cidades

✔ Associadas a um país ✔ CRUD completo ✔ Listar por país ✔ Listar por continente

---

💻 Tecnologias Utilizadas

Tecnologia	Descrição
TypeScript	Linguagem principal
Node.js	Backend
Prisma ORM 5.0	Modelagem + queries
MySQL	Banco relacional
Axios	Consumo de APIs externas
Bootstrap	Interface responsiva e intuitiva
Express	Rotas e controle
React/Vite	Construção da interface web
HTML/CSS/JS	Estrutura da UI

---

🧩 Integrações com APIs Externas

🔵 REST Countries

Fornece dados como:

• Bandeiras
• Regiões
• Idiomas
• Moeda
• Capital
• Geografia

📰 NewsData

Exibe notícias recentes sobre o país selecionado. Ideal para enriquecer o contexto do usuário 🌸

---

🗂 Estrutura do Projeto

Aqui está uma visualização real da estrutura do GeoNexus:

geonexus/
│
├── backend-geonexus/
│   ├── prisma/
│   │   ├── schema.prisma
│   │   └── migrations/
│   ├── src/
│   │   ├── controllers/
│   │   ├── services/
│   │   ├── routes/
│   │   ├── middlewares/
│   │   └── server.ts
│   └── package.json
│
├── frontend-geonexus/
│   ├── src/
│   │   ├── assets/
│   │   ├── pages/
│   │   ├── components/
│   │   ├── styles/
│   │   └── main.ts
│   └── index.html
│
└── README.md

Essa divisão organiza bem o backend e frontend, mantendo escalabilidade e clareza.

---

💡 Como Executar o Projeto

1️⃣ Clone o repositório

git clone https://github.com/raphaelamonteiro/geonexus.git
cd geonexus

2️⃣ Instale as dependências

npm install

3️⃣ Configure o .env

DATABASE_URL="mysql://usuario:senha@localhost:3306/geonexus"
REST_COUNTRIES_URL="https://restcountries.com/v3.1"
NEWSDATA_API_KEY="SUA_CHAVE_AQUI"

4️⃣ Gere o cliente Prisma

npx prisma migrate dev

5️⃣ Inicie o servidor

npm run dev

---

💌 Créditos

Desenvolvido por: Raphaela Monteiro

📘 Disciplina: Programação Web

Professor: André Olímpio

Curso: Análise e Desenvolvimento de Sistemas