Plataforma de Inteligência Artificial Preditiva para organizações corporativas, transformando dados históricos em insights acionáveis de desempenho financeiro.
- Sobre o Projeto
- Funcionalidades
- Arquitetura e Segurança
- Perfis de Usuário
- Requisitos do Sistema
- Instalação e Configuração
- Como Usar
- Casos de Uso
- Critérios de Aceitação
- Escopo do MVP
- Rastreabilidade de Requisitos
- Estrutura do Repositório
- Equipe
- Documentação
- Licença
O Visia é uma solução corporativa baseada em Inteligência Artificial Preditiva, desenvolvida para organizações que operam em ambientes VUCA (Volatility, Uncertainty, Complexity and Ambiguity) — realidade global marcada por mercados altamente dinâmicos e de difícil previsão.
Organizações modernas acumulam volumes massivos de dados, mas carecem de infraestrutura analítica para transformá-los em previsões confiáveis e acionáveis. Os principais gargalos identificados foram:
| Gargalo | Descrição |
|---|---|
| 📉 Baixa qualidade de dados | Dados internos inconsistentes ou mal estruturados |
| 🌪️ Volatilidade externa | Variáveis de mercado que mudam de forma rápida e imprevisível |
| 🧱 Limitações técnicas e humanas | Falta de infraestrutura analítica especializada |
- 📅 Previsões de desempenho financeiro de curto prazo (até 30 dias)
- 📅 Previsões de desempenho financeiro de médio prazo (até 180 dias)
- 📅 Indicações de tendências de longo prazo (sinalizadas como "
⚠️ Altamente Voláteis") - 🔔 Alertas automáticos de anomalias e variações expressivas
- 🖥️ Interface visual e intuitiva para usuários sem perfil técnico
- 📥 Importação de dados históricos nos formatos CSV e JSON
- 🧹 Tratamento, limpeza e classificação seguindo a Tríade CIA
- 🔒 Criptografia de dados sensíveis em repouso e em trânsito (TLS/HTTPS)
- 📋 Registro completo de logs de auditoria para todas as operações
- ⚡ Execução de modelos de I.A. Preditiva treinados sobre dados da organização
- 📊 Exibição do grau de confiança e margem de erro em cada previsão
⚠️ Marcação automática de previsões de longo prazo como "Altamente Voláteis"- 🔔 Emissão de alertas automáticos para anomalias detectadas
- 📉 Painéis e gráficos interativos interpretáveis por qualquer usuário
- 📆 Painel dedicado de métricas de desempenho semanal
- 🗂️ Histórico completo de previsões com comparação a resultados reais
- 📤 Exportação de relatórios em PDF e CSV (perfis autorizados)
- 👤 Cadastro, autenticação e gestão de perfis com RBAC (Role-Based Access Control)
- 🔑 Controle rigoroso de acesso por nível de perfil
- 📖 Seção de documentação integrada à interface
O Visia foi projetado sobre os três pilares da Tríade CIA de Segurança da Informação:
| Pilar | Significado | Como é implementado |
|---|---|---|
| 🔐 Confidencialidade | Acesso restrito conforme o perfil | RBAC + autenticação por níveis |
| ✅ Integridade | Dados protegidos contra alterações indevidas | Logs de auditoria + criptografia |
| 🟢 Disponibilidade | Sistema acessível sempre que necessário | Alta disponibilidade + mínimo de downtime |
- Comunicação via HTTPS com criptografia TLS em todas as requisições
- Dados em repouso criptografados com protocolos reconhecidos pelo mercado
- Fontes externas exigem certificados de procedência e integridade validados
- Zero tolerância a alterações de dados sem rastro de auditoria
- Conformidade com ISO/IEC 27001:2022 e NIST SP 800-12
| Perfil | Nível | Principais Permissões |
|---|---|---|
| 🔴 Administrador | Total | Gerenciar usuários, importar dados, auditar logs e configurar o sistema |
| 🟠 Gestor | Elevado | Visualizar painéis, gerar e exportar relatórios, receber alertas |
| 🟡 Analista Financeiro | Padrão | Selecionar ativos, gerar previsões, consultar histórico e receber alertas |
| 🟢 Usuário Geral | Básico | Visualizar painéis e consultar documentação |
⚠️ Regra de Negócio (RN04): Apenas perfis Gestor ou superior podem exportar relatórios brutos de tendências de mercado.
- Navegador moderno: Google Chrome, Mozilla Firefox ou Microsoft Edge
- Sem instalação de software adicional
- Conexão com internet (HTTPS/TLS obrigatório)
- Arquivos históricos em CSV ou JSON, devidamente estruturados
- Qualidade mínima garantida pela organização contratante
- Fontes externas devem possuir certificados de procedência validados
Existem duas formas de instalar e executar o Visia. Escolha a que melhor se adequa ao seu ambiente:
Recomendado para desenvolvedores e ambientes Linux/macOS/Windows com Python instalado.
# Passo 1 — Clone o repositório
git clone https://github.com/Daviddanillo/Visia.git
# Passo 2 — Acesse o diretório do projeto
cd Visia
# Passo 3 — Crie e ative o ambiente virtual
python -m venv venv
# Ativação no Linux/macOS:
source venv/bin/activate
# Ativação no Windows:
venv\Scripts\activate
# Passo 4 — Instale as dependências
pip install -r requirements.txt
# Passo 5 — Configure as variáveis de ambiente
cp .env.example .env
# Abra o arquivo .env e preencha com suas configurações locais
# Passo 6 — Execute a aplicação
python app.pyRecomendado para usuários finais no Windows que preferem uma inicialização rápida e automática.
# Passo 1 — Clone o repositório
git clone https://github.com/Daviddanillo/Visia.git
# Passo 2 — Acesse o diretório do projeto
cd VisiaPasso 3 — Localize o arquivo iniciar.bat na raiz do projeto e execute-o com duplo clique:
📁 Visia/
└── ▶️ iniciar.bat ← Execute este arquivo
✅ O script irá configurar o ambiente e iniciar a aplicação automaticamente, sem necessidade de configuração manual.