Women Go Safe

14 Dec 2025

Tempo de Leitura ~2 minutos

Ver Repositório

Explore o mundo com confiança. Feito por mulheres, para mulheres.

Sobre Nós • Funcionalidades • Tecnologias • Instalação • Estrutura

🌸 Sobre o Projeto

O Women Go Safe é uma plataforma de agendamento de intercâmbios focada exclusivamente na segurança e empoderamento feminino. Entendemos que viajar sozinha pode ser desafiador, por isso conectamos mulheres a agências e programas rigorosamente verificados.

Este repositório contém o MVP (Minimum Viable Product) da aplicação, simulando um ecossistema completo com busca de programas, avaliações de segurança baseadas em geolocalização e um hub de conhecimento.

✨ Funcionalidades

🔍 Busca Inteligente de Programas: Filtros avançados por destino, tipo de intercâmbio (curso, voluntariado, estágio) e agência.
🛡️ Selo de Verificação Women Go Safe: Sistema visual que destaca agências com suporte 24/7, liderança feminina e acomodações seguras.
🗺️ Mapa Interativo de Segurança: Utilizando Leaflet, visualizamos cidades com classificações de segurança (Verde, Amarelo, Vermelho) baseadas em feedbacks reais de usuárias.
📚 Hub de Conhecimento: Catálogo de cursos preparatórios e mentorias para auxiliar na adaptação cultural e carreira.
💬 Sistema de Avaliação e Feedback: Transparência total com comentários e notas de quem já viajou.
📢 Canal de Denúncia e Suporte: Fluxos dedicados para reportar problemas com agências ou solicitar informações.

🚀 Tecnologias

O projeto foi construído utilizando as melhores práticas de desenvolvimento web moderno:

Tech	Descrição
React 19	Biblioteca principal para construção da interface.
TypeScript	Tipagem estática para maior segurança e manutenibilidade do código.
Vite	Build tool de próxima geração, garantindo um ambiente de desenvolvimento ultrarrápido.
Tailwind CSS	Framework de utilitários para estilização ágil e responsiva.
Leaflet	Biblioteca open-source para mapas interativos.
React DOM	Gerenciamento da árvore de elementos do navegador.

📦 Como Rodar Localmente

Siga os passos abaixo para ter o projeto rodando na sua máquina:

Pré-requisitos

Node.js (Versão 18 ou superior recomendada)
npm ou yarn

Instalação

Clone o repositório:

git clone [https://github.com/krosct/Projetao-SafeJourney.git](https://github.com/krosct/Projetao-SafeJourney.git)
cd Projetao-SafeJourney

Instale as dependências:
```
npm install
# ou
yarn install
```
Configure as Variáveis de Ambiente: Crie um arquivo .env na raiz do projeto para configurar chaves de API.
```
VITE_GEMINI_API_KEY=sua_chave_aqui
```

Rode o servidor de desenvolvimento:

npm run build
# e
    
npm run dev
# ou
npm run preview

Acesse o projeto: Abra seu navegador em http://localhost:3000 (ou a porta indicada no terminal).

📂 Estrutura do Projeto

A organização de pastas segue um padrão modular para facilitar a escalabilidade:

/
├── components/    # Componentes reutilizáveis (Cards, Modais, Botões)
├── data/          # Mock Data (Dados simulados para o MVP)
├── pages/         # Páginas principais (Home, Map, Programs, etc.)
├── types.ts       # Definições de tipos globais (TypeScript)
├── App.tsx        # Componente raiz e Roteamento
└── main.tsx       # Ponto de entrada da aplicação

🤝 Contribuição

Contribuições são o que fazem a comunidade open source um lugar incrível para aprender, inspirar e criar. Qualquer contribuição que você fizer será muito apreciada.

Consulte o arquivo CONTRIBUTING.md para mais detalhes sobre como colaborar.

📝 Licença

Distribuído sob a licença MIT. Veja LICENSE para mais informações.

Feito com 💜 pela equipe Women Go Safe