ElaSegura — Aplicativo de Segurança para Mulheres
O ElaSegura é um aplicativo móvel desenvolvido para ajudar na proteção das mulheres. Ele permite que as usuárias enviem alertas de emergência (SOS) para contatos de confiança, registrem ocorrências de segurança e visualizem um mapa colaborativo em tempo real com áreas de risco em sua comunidade. O projeto é uma iniciativa de extensão universitária criada para promover a segurança pessoal por meio da tecnologia.
Funcionalidades
- Autenticação de Usuário — Cadastre-se, faça login e redefina sua senha com segurança. As senhas são criptografadas e as sessões são gerenciadas por meio de tokens JWT.
- Botão de Pânico (SOS) — Envie um alerta de emergência instantâneo compartilhando sua localização em tempo real com seus contatos de confiança.
- Contatos de Emergência — Adicione, edite e gerencie uma lista personalizada de contatos que serão notificados em caso de emergência.
- Mapa Interativo de Segurança — Visualize um mapa em tempo real utilizando Leaflet. Registre ocorrências e acompanhe áreas de risco marcadas pela comunidade.
- Registro de Ocorrências — Cadastre incidentes de segurança com título, descrição, tipo (erro ou aviso) e coordenadas de geolocalização.
- Feed de Alertas — Acompanhe uma linha do tempo com os alertas e ocorrências recentes registrados por você ou por usuários próximos.
- Caderno de Ocorrências — Escreva e salve anotações pessoais ou evidências relacionadas à sua segurança dentro do aplicativo.
- Perfil do Usuário — Atualize seu nome, e-mail e foto de perfil.
- Configurações — Ative ou desative o compartilhamento de localização e as preferências de notificações. O aplicativo detecta automaticamente o endereço IP do servidor backend, sem necessidade de configuração manual.
- Modo Claro e Escuro — Suporte completo aos temas claro e escuro em todas as telas.
Tecnologias
Frontend (Aplicativo Mobile)
| Tecnologia | Finalidade |
|---|
| React Native | Framework multiplataforma para desenvolvimento mobile |
| Expo (SDK 54) | Ferramentas de desenvolvimento e módulos nativos |
| Expo Router | Navegação baseada em arquivos |
| TypeScript | Tipagem estática |
| Leaflet (via WebView) | Renderização do mapa interativo |
| TanStack React Query | Gerenciamento do estado do servidor |
| Expo Location | Acesso ao GPS e geolocalização |
| Expo Notifications | Notificações locais |
| AsyncStorage | Armazenamento local persistente |
| Expo Blur | Efeitos de desfoque para pop-ups da interface |
Backend (API REST)
| Tecnologia | Finalidade |
|---|
| Node.js | Ambiente de execução |
| Express.js | Servidor HTTP e roteamento |
| TypeScript | Tipagem estática |
| PostgreSQL | Banco de dados relacional |
node-postgres (pg) | Cliente de conexão com PostgreSQL |
| bcryptjs | Criptografia de senhas |
| JSON Web Token (JWT) | Autenticação sem estado (Stateless) |
| dotenv | Gerenciamento de variáveis de ambiente |
| nodemon | Reinicialização automática durante o desenvolvimento |
Como Executar
Requisitos
- Node.js versão 18 ou superior
- PostgreSQL instalado e em execução localmente
- Aplicativo Expo Go instalado em seu dispositivo Android ou iOS
- O computador e o celular devem estar conectados à mesma rede Wi-Fi
Passo 1 — Configurar o Backend
Abra um terminal dentro da pasta server:
cd server
npm install
Renomeie o arquivo de exemplo das variáveis de ambiente e configure suas credenciais:
cp .env.example .env
Abra o arquivo .env e configure a conexão com o PostgreSQL:
DATABASE_URL=postgresql://SEU_USUARIO:SUA_SENHA@localhost:5432/elasegura
JWT_SECRET=sua_chave_secreta
PORT=3000
Observação: É necessário criar previamente um banco de dados PostgreSQL chamado elasegura. As tabelas serão criadas automaticamente na primeira execução.
Inicie o servidor backend:
npm run dev
A API ficará disponível em:
http://localhost:3000
Passo 2 — Configurar o Frontend
Abra outro terminal dentro da pasta ElaSegura:
cd ElaSegura
npm install
Inicie o aplicativo:
npm start
O Expo Metro Bundler será aberto. Escaneie o QR Code utilizando o aplicativo Expo Go no seu celular ou pressione:
a para abrir no emulador Android;i para abrir no simulador iOS.
Observação: O aplicativo detecta automaticamente o endereço IP local do computador. Não é necessário criar ou editar nenhum arquivo .env no frontend.
