How simonequeiroz/cti_nexus works
CTI Nexus transforma planilhas comerciais em dados validados, relatórios de qualidade e análises da carteira. O fluxo principal vai do envio e leitura no navegador à correção e liberação, passando pela validação Java e pelo ETL Python, que grava os dados; depois, API e dashboard permitem consultá-los. A plataforma também oferece autenticação por papéis e administração de usuários. As relações seguem o README e os vínculos explícitos nos trechos e no SOURCE INDEX; subsistemas não amostrados são representados apenas quando documentados.
Main entry points: uploadStore.js Estado do envio · api.js Cliente HTTP · api.py Entrada do ETL · uploadService.js Serviço de envio
Components 32
Fluxo no navegador
- Envio da planilha
frontend-vue/src/views/PaginaUpload.vue - Leitura da planilha
frontend-vue/src/utils/leituraPlanilha.js - Correção e liberação
frontend-vue/src/views/PaginaValidacao.vue - Estado do envio
frontend-vue/src/stores/uploadStore.js - Serviço de envio
frontend-vue/src/services/uploadService.js - Cliente HTTP
frontend-vue/src/services/api.js - Login e acesso
frontend-vue/src/views/PaginaLogin.vue - Estado de autenticação
frontend-vue/src/stores/autenticacaoStore.js - Gestão de usuários
frontend-vue/src/views/PaginaUsuarios.vue
API e acesso
- API de autenticação
backend-java/src/main/java/br/com/ctinexus/controller/AutenticacaoController.java - Regras de autenticação
backend-java/src/main/java/br/com/ctinexus/service/AutenticacaoService.java - Tokens JWT
backend-java/src/main/java/br/com/ctinexus/security/JwtService.java - Administração de usuários
backend-java/src/main/java/br/com/ctinexus/service/UsuarioService.java - Persistência de usuários
backend-java/src/main/java/br/com/ctinexus/repository/UsuarioRepository.java - API de cargas
backend-java/src/main/java/br/com/ctinexus/controller/UploadController.java - Orquestração da carga
backend-java/src/main/java/br/com/ctinexus/service/UploadService.java - Validação no servidor
backend-java/src/main/java/br/com/ctinexus/service/ClienteValidacaoService.java - Ponte para Python
backend-java/src/main/java/br/com/ctinexus/service/PythonEtlService.java - API de clientes
backend-java/src/main/java/br/com/ctinexus/controller/ClienteController.java - Consulta de cargas
backend-java/src/main/java/br/com/ctinexus/service/ConsultaCargaService.java
ETL e análise
- Entrada do ETL
analytics-python/api.py - Limpeza e padronização
analytics-python/limpeza.py - Estatísticas da carteira
analytics-python/analise.py - Gravação do ETL
analytics-python/banco.py - Gráficos analíticos
analytics-python/graficos.py
Relatórios e painel
- Relatório de qualidade
frontend-vue/src/views/PaginaRelatorio.vue - Dashboard
frontend-vue/src/views/PaginaDashboard.vue - Dados e insights
frontend-vue/src/utils/dadosDashboard.js
Other components
- Analista
- Gestor
- Administrador
- PostgreSQL Neon
Connections 39
- Analista → Envio da planilha: envia planilha
- Envio da planilha → Estado do envio: inicia envio
- Estado do envio → Leitura da planilha: lê arquivo
frontend-vue/src/stores/uploadStore.js - Analista → Correção e liberação: corrige linhas
- Correção e liberação → Estado do envio: confirma correções
- Estado do envio → Serviço de envio: solicita envio
frontend-vue/src/stores/uploadStore.js - Serviço de envio → Cliente HTTP: chama API
frontend-vue/src/services/uploadService.js - Cliente HTTP → API de cargas: envia requisição
- API de cargas → Orquestração da carga: delegação
- Orquestração da carga → Validação no servidor: revalida linhas
backend-java/src/main/java/br/com/ctinexus/service/UploadService.java - Orquestração da carga → Ponte para Python: envia válidas
backend-java/src/main/java/br/com/ctinexus/service/UploadService.java - Ponte para Python → Entrada do ETL: chama ETL
- Entrada do ETL → Limpeza e padronização: limpa dados
analytics-python/api.py - Entrada do ETL → Estatísticas da carteira: calcula estatísticas
analytics-python/api.py - Entrada do ETL → Gravação do ETL: grava lote
analytics-python/api.py - Entrada do ETL → Gráficos analíticos: gera gráficos
analytics-python/api.py - Gravação do ETL → PostgreSQL Neon: grava dados
- Gráficos analíticos → PostgreSQL Neon: consulta dados
analytics-python/graficos.py - Analista → Relatório de qualidade: consulta relatório
- Gestor → Relatório de qualidade: consulta relatório
- Analista → Dashboard: consulta painel
- Gestor → Dashboard: consulta painel
- Dashboard → Estado do envio: consulta dados
- Estado do envio → Serviço de envio: consulta cargas
frontend-vue/src/stores/uploadStore.js - Serviço de envio → Cliente HTTP: chama API
frontend-vue/src/services/uploadService.js - Cliente HTTP → API de clientes: consulta clientes
- API de clientes → Consulta de cargas: obtém dados
- Consulta de cargas → PostgreSQL Neon: lê dados
- Dashboard → Dados e insights: monta análises
- Administrador → Gestão de usuários: administra contas
- Gestão de usuários → Cliente HTTP: solicita operações
- Cliente HTTP → Administração de usuários: chama API
- Administração de usuários → Persistência de usuários: lê e grava
backend-java/src/main/java/br/com/ctinexus/service/UsuarioService.java - Persistência de usuários → PostgreSQL Neon: persiste usuários
- Login e acesso → Estado de autenticação: inicia sessão
- Estado de autenticação → API de autenticação: solicita login
- API de autenticação → Regras de autenticação: delega autenticação
backend-java/src/main/java/br/com/ctinexus/controller/AutenticacaoController.java - Regras de autenticação → Tokens JWT: gera token
backend-java/src/main/java/br/com/ctinexus/service/AutenticacaoService.java - Regras de autenticação → Persistência de usuários: consulta usuários
backend-java/src/main/java/br/com/ctinexus/service/AutenticacaoService.java