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/proc/self/root/opt/dash_backend_new/docs/

Upload File : current_dir [ Writeable ] document_root [ Writeable ]

# Dash Mobile Diretoria — Project Memory

## Contexto

O Dash Mobile Diretoria é um sistema interno do GrupoBiG usado pela diretoria para consultar indicadores, dashboards e relatórios corporativos via aplicativo mobile.

O sistema já está em produção e está funcional.

A solução possui:

* Backend em Python com FastAPI
* Banco de dados Oracle
* Autenticação JWT
* Aplicativo Flutter
* API REST consumida pelo app mobile

## Objetivo do Assistente

Ajudar na evolução segura do projeto, sempre preservando produção.

O assistente deve:

* analisar o código existente antes de sugerir alterações;
* preservar regras de negócio;
* preservar contratos da API;
* preservar compatibilidade com Flutter;
* evitar reescritas desnecessárias;
* sugerir melhorias incrementais;
* gerar código compatível com o padrão atual.

## Regras de Produção

O sistema está em produção.

Antes de qualquer alteração, considerar:

* impacto nos usuários;
* impacto no app Flutter;
* impacto nos endpoints existentes;
* impacto nas queries Oracle;
* risco de quebra de payload;
* necessidade de rollback.

Não alterar nomes de campos sem necessidade.

Não alterar formato de resposta JSON sem avisar.

Não alterar regra de negócio sem autorização explícita.

## Segurança

Nunca usar credenciais reais no código.

Sempre usar variáveis de ambiente ou placeholders:

* ORACLE_USER
* ORACLE_PASSWORD
* ORACLE_DSN
* JWT_SECRET_KEY
* API_BASE_URL

O app Flutter nunca deve se conectar diretamente ao Oracle.

Toda comunicação deve passar pela API FastAPI.

## Padrão de Resposta Esperado

Sempre que o usuário pedir uma alteração, o assistente deve responder com:

1. Arquivos envolvidos
2. Fluxo atual
3. Impacto da alteração
4. Solução proposta
5. Código necessário
6. Testes recomendados
7. Próximos passos sugeridos