🛣️ProFrotas Gestor

Documentação APP Profrotas

Documentação do Projeto PROFROTAS

1. Visão Geral do Projeto

Objetivo do Projeto

O objetivo desse projeto é entregar para os gestores uma maneira de organizar e ter acesso a todas as informações necessárias relacionadas a motoristas, veículos, postos etc, e também realizar configurações na sua conta.

Descrição Geral

O app permite que o usuário acesse motoristas, veículos, postos internos e externos, configurar parametros de uso, e facilitar o seu dia a dia.

Principais Funcionalidades

  • Visualização e edição de motoristas

  • Visualização e edição de veículos

  • Visualização e edição de abastecimentos

  • Visualização e edição de paramêtros de uso

  • Visualização e edição de postos de gasolina

  • Visualização de rotas

Público-Alvo

Gestores de Motoristas Ipiranga.

2. Configuração do Ambiente

Pré-requisitos

  • Flutter SDK 3.7.3 ou superior

  • Dart

    sdk: ">=2.17.1 <3.0.0"
  • Android Studio / Xcode

  • Emulador ou dispositivo físico para testes

Instruções de Instalação

Passo a passo para instalar o projeto localmente.

Exemplo:

  1. Clone o repositório: git clone https://github.com/seu-usuario/seu-projeto.git

  2. Navegue até o diretório do projeto: cd seu-projeto

  3. Instale as dependências: flutter pub get && flutter pub run build_runner build --delete-conflicting-outputs

Configuração do Ambiente de Desenvolvimento

Branch mais atualizada: develop

Dependências e Pacotes Utilizados

Listar as principais dependências e pacotes.

  • google_maps_flutter e google_map_polyline_new para criação e manipulação de mapas.

  • extended_masked_text para formatar número em reais

  • local_auth utilizado para entrar na aplicação apenas se passar pela autorização do dispositivo.

  • autocomplete_textfield para text field com auto complete em mts casos de uso

  • dio, json_serializable, getIt para http e injeção de dependencias

3. Arquitetura do Projeto

Estrutura de Diretórios

O projeto utiliza a estrutura antiga do nosso leap

  • lib/src: Contém o código fonte principal

    • domain/

      • repositories

      • services

      • usecases

    • external/:

      • datasources

      • models

    • presentation/:

      • stores

      • usecases

      • views

      • widgets

    • utils/:

      • helpers

      • setups

Padrões de Arquitetura Utilizados

O projeto utiliza de arquitetura limpa, utilizando de monorepo (tudo no mesmo repositorio, nada mais apartado), com separação entre domain, external e presentation. Sem separação por módulos.

Gerenciamento de Estado

Está sendo utilizado MOBX com GetIt para injeção da dependência.

4. Deploy e Publicação

Processo de Build

Explicar como gerar o build do aplicativo.

Exemplo:

  • Para Android: flutter build apk

  • Para iOS: flutter build ios

Instruções para Deploy

Está tudo configurado no CODEMAGIC na conta de Edu.

Last updated