MANEJA Frontend

Aplicação mobile para apoio ao gerenciamento de propriedades rurais e atividades de manejo.

Sobre o projeto

O MANEJA é uma aplicação voltada ao apoio do gerenciamento de propriedades rurais, com foco na organização das informações utilizadas no manejo e acompanhamento do rebanho.

Este repositório contém o frontend mobile da aplicação, responsável pela experiência do usuário, navegação entre os fluxos da aplicação e integração com a API do projeto.

Pré-requisitos

Antes de executar o projeto, tenha instalado:

Para utilizar funcionalidades que dependem de dados persistentes, a MANEJA API também deve estar em execução.

Executando o projeto

1. Clone o repositório

git clone https://github.com/Leafth/maneja-frontend.git

Entre no diretório:

cd maneja-frontend

2. Instale as dependências

npm install

3. Configure as variáveis de ambiente

Crie um arquivo .env na raiz do projeto.

EXPO_PUBLIC_API_URL=http://SEU_IP:3000/api/v1

Em um dispositivo físico, localhost aponta para o próprio dispositivo. Para acessar uma API executada no computador, utilize o endereço IP da máquina na rede.

4. Inicie o Expo

npx expo start

Escaneie o QR Code utilizando o Expo Go ou abra a aplicação através de um ambiente Android/iOS configurado.

Limpando o cache

npx expo start --clear

Scripts

Os principais comandos utilizados durante o desenvolvimento são:

# Iniciar o projeto
npx expo start

# Iniciar limpando o cache
npx expo start --clear

# Verificar o código com o lint
npm run lint

---

Estrutura do projeto

A aplicação utiliza src/app como raiz do Expo Router e organiza as funcionalidades por feature. As responsabilidades e regras entre essas camadas estão descritas em ARCHITECTURE.md.

Integração com a API

O frontend utiliza a MANEJA API para autenticação e demais funcionalidades persistentes.

Repositório: MANEJA API

A URL base utilizada pela aplicação é definida por:

EXPO_PUBLIC_API_URL

Ao testar em dispositivo físico, certifique-se de que o dispositivo consegue acessar a máquina onde a API está sendo executada.

Documentação

A documentação do projeto está dividida da seguinte forma:

Arquivo	Conteúdo
README.md	Visão geral, tecnologias, configuração e execução
CONTRIBUTING.md	Padrões que devem ser seguidos durante o desenvolvimento
ARCHITECTURE.md	Arquitetura, camadas e responsabilidades estruturais

• Guia de desenvolvimento
• Arquitetura do projeto