Server : Apache System : Linux dedi-14684855.grupobig.com 5.14.0-611.49.1.el9_7.x86_64 #1 SMP PREEMPT_DYNAMIC Tue Apr 21 16:39:08 EDT 2026 x86_64 User : grupo692 ( 1004) PHP Version : 8.3.33 Disable Function : NONE Directory :  /proc/thread-self/root/opt/dash_backend/docs/

Upload File : current_dir [ Writeable ] document_root [ Writeable ]

# Dash Mobile Diretoria — Mobile Guide

## Stack Mobile

O aplicativo mobile utiliza Flutter.

O app consome exclusivamente a API FastAPI.

O app não deve acessar diretamente o banco Oracle.

## Responsabilidades do App

O app é responsável por:

* exibir tela de login;
* armazenar token com segurança;
* consumir endpoints da API;
* exibir dashboards;
* exibir relatórios;
* tratar carregamento;
* tratar erros;
* tratar sessão expirada.

## Autenticação

O login deve ocorrer pela API.

Após login válido:

* receber token JWT;
* armazenar token de forma segura;
* reutilizar token nas próximas chamadas;
* redirecionar para login se o token expirar.

## Consumo da API

Todas as chamadas HTTP devem passar por serviço centralizado.

O app deve tratar:

* timeout;
* erro 401;
* erro 403;
* erro 500;
* ausência de conexão;
* resposta vazia;
* JSON inesperado.

## Telas

As telas devem preservar o padrão visual atual.

Ao criar nova tela:

* usar layout responsivo;
* exibir loading;
* exibir mensagem amigável de erro;
* exibir estado vazio;
* evitar travamentos;
* manter navegação consistente.

## Compatibilidade

Antes de alterar qualquer payload vindo da API, avaliar impacto nas telas existentes.

Não alterar nomes de campos consumidos pelo Flutter sem ajustar o app.

Não alterar rotas internas sem necessidade.

## Segurança

Não armazenar credenciais no app.

Não colocar IPs, senhas ou DSNs no código.

Usar API_BASE_URL configurável.