N Report APP

Uma aplicação para gerenciamento de denúncias criminais, com funcionalidades de registro, visualização em mapas e gerenciamento de ocorrências.

Índice

• Badges
• Índice
• Sobre o Projeto
• Técnologias Usadas
• Executar o Projeto
• Funcionalidades
• Capturas de Tela
• Como Contribuir
• Autor

Sobre o Projeto

O N Report é um aplicativo de gerenciamento de denúncias criminais. Ele permite que os usuários registrem ocorrências informando a localização do crime, um título, uma breve descrição, e anexem imagens relacionadas. Além disso, é possível visualizar todas as ocorrências em um mapa, com base na localização atual do usuário, ou navegar por diferentes regiões para ver relatos em outros locais.

O aplicativo se comunica com uma API desenvolvida especificamente para a persistência e obtenção dos dados, tanto dos usuários quanto das denúncias. Ele possui dois níveis de permissões: usuário comum e admin. O usuário comum pode se cadastrar pelo aplicativo, registrar e visualizar denúncias no mapa, mas só pode editar ou excluir as denúncias que ele próprio criou. Já o admin tem acesso total, podendo visualizar, editar e excluir qualquer denúncia cadastrada no sistema.

Além de facilitar o registro de ocorrências criminais de maneira prática e acessível, o N Report pode ser uma ferramenta valiosa para promover a segurança em comunidades. Ele permite que as pessoas se mantenham informadas sobre crimes ocorridos em sua área ou em outras regiões de interesse, ajudando na criação de uma rede colaborativa de vigilância e conscientização. Governos, autoridades locais e organizações de segurança também podem utilizar o aplicativo para monitorar áreas de maior incidência criminal, tomar decisões mais informadas e alocar recursos de maneira mais eficiente.

API

Técnologias Usadas

Executar o Projeto

Pré-requisitos: Node JS (14.x ou superior), Expo CLI, Emulador Android ou iOS

OBS: Certifique-se que a API está em execução

Clonar repositório

git clone https://github.com/AntLacerda/n-report-app n-report-app

Entrar na pasta do projeto

cd n-report-app

Clonar arquivos com variáveis de ambiente

cp .env.example .env

Editar variáveis de ambiente

# Exemplo de variáveis de ambiente:
API_URL=http://192.168.1.x:3000

OBS: O IP colocado aqui é padrão do emulador do Android Studio, caso você execute pelo Expo no celular, coloque o IP do seu computador na rede local (192.168.1.x). A porta é a que a API está rodando

Instalar depedências do projeto

npm i

Executar o projeto

npm run start

Funcionalidades

• Registro de ocorrências com localização, descrição e imagens.
• Visualização de ocorrências em um mapa baseado na localização atual do usuário.
• Navegação no mapa para ver ocorrências em diferentes regiões.
• Gerenciamento de permissões: usuários comuns e administradores.

Capturas de Tela

Como Contribuir

Se você quiser contribuir com o N Report, sinta-se à vontade para abrir uma issue ou enviar um pull request. Toda ajuda é bem-vinda! Siga os seguintes passos:

1. Fork o repositório.
2. Crie uma nova branch: git checkout -b feature/NRA-{Número da Issue}.
3. Faça suas alterações e commite: git commit -m 'Minha melhoria'.
4. Envie o pull request.

Autores

João Darwin
Antônio Lacerda
Eduardo Dênis