How tatianaifsp/cti-projeto-deploy works
CTI Insights accepts customer spreadsheets, previews validation errors, and persists only valid rows. The primary path runs from the Vue upload experience through Java validation/orchestration to Python cleaning, analysis, and persistence; Java then serves stored dashboard statistics to Vue. Separate capabilities include JWT-based access, account administration, and reporting. Edges reflect README statements and source-index references; several controller/API implementation details were not sampled, so those links are documented or left unverified.
Main entry points: api.js API client · main.py Analysis pipeline · UploadService.java Upload orchestration · UploadView.vue Upload screen
Components 26
Vue application
- Upload screen
frontend/src/views/UploadView.vue - Upload state
frontend/src/stores/upload.js - API client
frontend/src/services/api.js - Login and registration
frontend/src/stores/auth.js - User administration
frontend/src/views/AdminUsuariosView.vue
Java backend
- Upload endpoint
backend/src/main/java/com/cti/provedor/controller/UploadController.java - Upload orchestration
backend/src/main/java/com/cti/provedor/service/UploadService.java - Row validation
backend/src/main/java/com/cti/provedor/service/ClienteValidacaoService.java - Python ETL client
backend/src/main/java/com/cti/provedor/service/PythonEtlService.java
Python analytics
- ETL API
analytics-python/api.py - Analysis pipeline
analytics-python/main.py - Cleaning and standardization
analytics-python/limpeza.py - Client analysis
analytics-python/analise.py - Insight calculation
analytics-python/insights.py - Data persistence
analytics-python/banco.py
Identity and administration
- Authentication endpoints
backend/src/main/java/com/cti/provedor/controller/AuthController.java - Authentication rules
backend/src/main/java/com/cti/provedor/service/AuthService.java - User repository
backend/src/main/java/com/cti/provedor/repository/UsuarioRepository.java - Admin endpoints
backend/src/main/java/com/cti/provedor/controller/AdminUsuarioController.java - User management
backend/src/main/java/com/cti/provedor/service/UsuarioService.java
Dashboard and reporting
- Dashboard view
frontend/src/views/DashboardView.vue - Dashboard endpoint
backend/src/main/java/com/cti/provedor/controller/DashboardController.java - Dashboard queries
backend/src/main/java/com/cti/provedor/service/DashboardService.java - Upload report
frontend/src/views/RelatorioView.vue
Other components
- User
- PostgreSQL / Neon
Connections 29
- User → Upload screen: uploads spreadsheet
README.md - Upload screen → Upload state: uses upload state
- Upload state → API client: sends valid rows
README.md - API client → Upload endpoint: calls backend
README.md - Upload endpoint → Upload orchestration: delegates upload
backend/src/main/java/com/cti/provedor/service/UploadService.java - Upload orchestration → Row validation: validates rows
backend/src/main/java/com/cti/provedor/service/UploadService.java - Upload orchestration → Python ETL client: forwards valid rows
backend/src/main/java/com/cti/provedor/service/UploadService.java - Python ETL client → ETL API: sends ETL request
README.md - ETL API → Analysis pipeline: dispatches processing
- Analysis pipeline → Cleaning and standardization: cleans data
analytics-python/main.py - Analysis pipeline → Client analysis: analyzes data
analytics-python/main.py - Client analysis → Insight calculation: uses insights
analytics-python/analise.py - Analysis pipeline → Data persistence: persists results
analytics-python/main.py - Data persistence → PostgreSQL / Neon: writes batches and statistics
README.md - User → Login and registration: signs in
README.md - Login and registration → API client: calls auth service
frontend/src/stores/auth.js - API client → Authentication endpoints: calls backend
README.md - Authentication endpoints → Authentication rules: delegates authentication
backend/src/main/java/com/cti/provedor/controller/AuthController.java - Authentication rules → User repository: reads and saves users
backend/src/main/java/com/cti/provedor/service/AuthService.java - User → User administration: manages accounts
README.md - User administration → Admin endpoints: calls admin API
- Admin endpoints → User management: delegates management
backend/src/main/java/com/cti/provedor/controller/AdminUsuarioController.java - User management → User repository: queries users
backend/src/main/java/com/cti/provedor/service/UsuarioService.java - User → Dashboard view: views charts
README.md - Dashboard view → API client: requests statistics
frontend/src/views/DashboardView.vue - API client → Dashboard endpoint: calls dashboard API
README.md - Dashboard endpoint → Dashboard queries: delegates query
backend/src/main/java/com/cti/provedor/controller/DashboardController.java - Dashboard queries → PostgreSQL / Neon: reads statistics
README.md - User → Upload report: reviews upload report