How maikezzk7-spec/cti works
This is a CTI customer-insights portal: users upload customer spreadsheets, the backend validates and forwards accepted rows to Python ETL/analytics, and the frontend presents customer, dashboard, chart, and report views. Account registration, login, session checks, and administrator user management support access to the portal. The source index and excerpts establish the upload and analytics handoffs; several view implementations and runtime integrations were not sampled, so those links are omitted or marked unverified.
Main entry points: index.js Route guard · main.py ETL entry point · AuthController.java Auth endpoints · AuthService.java Auth service
Components 25
Portal UI
- Route guard
frontend/src/router/index.js - Customer browser
frontend/src/views/ClientesView.vue - Insights views
frontend/src/views - Upload screen
frontend/src/views/UploadView.vue - Upload state
frontend/src/stores/uploadStore.js - API client
frontend/src/services/api.js
Accounts & Access
- Auth state
frontend/src/stores/auth.js - Auth endpoints
backend/src/main/java/com/cti/provedor/controller/AuthController.java - Auth service
backend/src/main/java/com/cti/provedor/service/AuthService.java - User administration
backend/src/main/java/com/cti/provedor/service/UsuarioService.java - User repository
backend/src/main/java/com/cti/provedor/repository/UsuarioRepository.java - User account
backend/src/main/java/com/cti/provedor/model/Usuario.java - JWT service
backend/src/main/java/com/cti/provedor/config/JwtService.java
Customer Upload
- Upload endpoint
backend/src/main/java/com/cti/provedor/controller/UploadController.java - Upload coordinator
backend/src/main/java/com/cti/provedor/service/UploadService.java - Row validation
backend/src/main/java/com/cti/provedor/service/ClienteValidacaoService.java - Python ETL bridge
backend/src/main/java/com/cti/provedor/service/PythonEtlService.java
ETL & Analytics
- ETL entry point
analytics-python/main.py - Spreadsheet cleanup
analytics-python/limpeza.py - Customer analysis
analytics-python/analise.py - Insight generation
analytics-python/insights.py - Analytics database access
analytics-python/banco.py - Customer data store
Other components
- Portal user
- Portal backend
Connections 28
- Portal user → Route guard: opens portal
frontend/src/router/index.js - Route guard → Insights views: routes to
frontend/src/router/index.js - Route guard → Upload screen: routes to
frontend/src/router/index.js - Route guard → Customer browser: routes to
frontend/src/router/index.js - Route guard → Auth state: checks session
frontend/src/router/index.js - Customer browser → Upload state: reads customer data
frontend/src/views/ClientesView.vue - Auth state → API client: uses API
frontend/src/stores/auth.js - Upload screen → Upload state: uses upload state
- Upload state → API client: submits upload
- API client → Portal backend: HTTP requests
- Portal backend → Auth endpoints: dispatches auth
- Portal backend → Upload endpoint: dispatches upload
- Auth endpoints → Auth service: calls
backend/src/main/java/com/cti/provedor/controller/AuthController.java - Auth endpoints → User administration: calls
backend/src/main/java/com/cti/provedor/controller/AuthController.java - Auth service → JWT service: issues token
backend/src/main/java/com/cti/provedor/service/AuthService.java - Auth service → User repository: reads and saves
backend/src/main/java/com/cti/provedor/service/AuthService.java - User administration → User repository: manages accounts
backend/src/main/java/com/cti/provedor/service/UsuarioService.java - User repository → User account: persists
backend/src/main/java/com/cti/provedor/repository/UsuarioRepository.java - Upload endpoint → Upload coordinator: calls
backend/src/main/java/com/cti/provedor/controller/UploadController.java - Upload coordinator → Row validation: validates rows
backend/src/main/java/com/cti/provedor/service/UploadService.java - Upload coordinator → Python ETL bridge: forwards accepted rows
backend/src/main/java/com/cti/provedor/service/UploadService.java - Python ETL bridge → ETL entry point: invokes ETL
- ETL entry point → Spreadsheet cleanup: calls cleanup
analytics-python/main.py - ETL entry point → Customer analysis: calls analysis
analytics-python/main.py - ETL entry point → Analytics database access: uses database access
analytics-python/main.py - Customer analysis → Spreadsheet cleanup: uses cleaned data
analytics-python/analise.py - Customer analysis → Insight generation: uses insights
analytics-python/analise.py - Analytics database access → Customer data store: reads and writes