# luciano8383/projeto_cloud_io_systems architecture

> Architecture diagram of the GitHub repository luciano8383/projeto_cloud_io_systems, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/luciano8383/projeto_cloud_io_systems
- Repository: https://github.com/luciano8383/projeto_cloud_io_systems

## Overview

This repository implements a web application for uploading client spreadsheets, validating and analyzing the data, and viewing dashboard results, alongside user authentication and administration. The Vue frontend calls a Spring backend; the documented Python ETL processes valid upload rows and stores analytics results, which the dashboard backend reads. Authentication uses JWTs and a separate user store. The Python processing stages are visible in sampled source; some HTTP and upload wiring is not, so those links are marked unverified.

Main entry points: [`FrontEnd/src/services/api.js`](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/services/api.js) (API client), [`FrontEnd/src/router/index.js`](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/router/index.js) (View router), [`CienciaD/main.py`](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/CienciaD/main.py) (Batch processor), [`FrontEnd/src/views/Upload.vue`](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/views/Upload.vue) (Upload screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web interface"]
  node_upload_ui["Upload screen<br/>[Upload.vue]"]
  node_dashboard_ui["Dashboard screen<br/>[Dashboard.vue]"]
  node_report_ui["Report screen<br/>[Relatorio.vue]"]
  node_login_ui["Login screen<br/>[Login.vue]"]
  node_user_ui["User screen<br/>[Usuario.vue]"]
  node_router["View router<br/>[index.js]"]
  node_auth_store["Auth state<br/>[auth.js]"]
  node_upload_store["Upload state<br/>[UploadStore.js]"]
  node_http_client["API client<br/>[api.js]"]
end

subgraph group_backend["Spring API"]
  node_upload_controller["Upload endpoint"]
  node_upload_service["Upload workflow<br/>[UploadService.java]"]
  node_validation["Client validation"]
  node_python_bridge["Python ETL bridge"]
  node_dashboard_controller["Dashboard endpoint"]
  node_dashboard_service["Dashboard queries"]
end

subgraph group_identity["User identity"]
  node_auth_controller["Auth endpoint"]
  node_auth_service["Auth rules<br/>[AuthService.java]"]
  node_admin_controller["User administration"]
  node_user_service["User management"]
  node_user_repository["User repository"]
  node_user_entity["User account<br/>[Usuario.java]"]
end

subgraph group_analytics["Data analytics"]
  node_python_api["Analytics API<br/>[api.py]"]
  node_batch_runner["Batch processor<br/>[main.py]"]
  node_cleaning["Data cleaning<br/>[limpeza.py]"]
  node_analysis["Statistics<br/>[analise.py]"]
  node_insights["Insight generation<br/>[insights.py]"]
  node_analytics_store["Analytics persistence<br/>[banco.py]"]
end

node_person(("User"))
node_analytics_db[("Analytics database")]
node_user_db[("User database")]

node_person -.->|"uploads file"| node_upload_ui
node_person -.->|"signs in"| node_login_ui
node_router -->|"routes to"| node_upload_ui
node_router -->|"routes to"| node_dashboard_ui
node_router -->|"routes to"| node_report_ui
node_router -->|"routes to"| node_login_ui
node_router -->|"routes to"| node_user_ui
node_login_ui -->|"uses auth"| node_auth_store
node_auth_store -->|"sends requests"| node_http_client
node_upload_ui -.->|"uses upload state"| node_upload_store
node_upload_ui -.->|"sends upload"| node_http_client
node_dashboard_ui -.->|"requests data"| node_http_client
node_http_client -.->|"HTTP upload"| node_upload_controller
node_http_client -.->|"HTTP auth"| node_auth_controller
node_http_client -.->|"HTTP dashboard"| node_dashboard_controller
node_upload_controller -->|"delegates to"| node_upload_service
node_upload_service -->|"validates rows"| node_validation
node_upload_service -->|"invokes ETL"| node_python_bridge
node_python_bridge -.->|"submits batch"| node_python_api
node_python_api -->|"dispatches batch"| node_batch_runner
node_batch_runner -->|"cleans rows"| node_cleaning
node_batch_runner -->|"calculates metrics"| node_analysis
node_analysis -->|"generates insights"| node_insights
node_batch_runner -->|"writes results"| node_analytics_store
node_analytics_store -.->|"persists batch"| node_analytics_db
node_dashboard_controller -->|"delegates to"| node_dashboard_service
node_dashboard_service -->|"reads results"| node_analytics_db
node_auth_controller -->|"delegates to"| node_auth_service
node_auth_service -->|"reads and saves"| node_user_repository
node_auth_service -->|"creates account"| node_user_entity
node_admin_controller -->|"delegates to"| node_user_service
node_user_service -->|"manages users"| node_user_repository
node_user_repository -->|"stores accounts"| node_user_entity
node_user_repository -.->|"reads and writes"| node_user_db

click node_upload_ui "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/views/Upload.vue"
click node_dashboard_ui "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/views/Dashboard.vue"
click node_report_ui "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/views/Relatorio.vue"
click node_login_ui "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/views/Login.vue"
click node_user_ui "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/views/Usuario.vue"
click node_router "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/router/index.js"
click node_auth_store "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/Stores/auth.js"
click node_upload_store "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/Stores/UploadStore.js"
click node_http_client "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/services/api.js"
click node_upload_controller "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/controller/UploadController.java"
click node_upload_service "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/UploadService.java"
click node_validation "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/ClienteValidacaoService.java"
click node_python_bridge "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/PythonEtlService.java"
click node_dashboard_controller "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/controller/DashboardController.java"
click node_dashboard_service "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/DashboardService.java"
click node_auth_controller "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/controller/AuthController.java"
click node_auth_service "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/AuthService.java"
click node_admin_controller "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/controller/AdminUsuarioController.java"
click node_user_service "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/UsuarioService.java"
click node_user_repository "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/repository/UsuarioRepository.java"
click node_user_entity "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/model/Usuario.java"
click node_python_api "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/CienciaD/api.py"
click node_batch_runner "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/CienciaD/main.py"
click node_cleaning "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/CienciaD/limpeza.py"
click node_analysis "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/CienciaD/analise.py"
click node_insights "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/CienciaD/insights.py"
click node_analytics_store "https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/CienciaD/banco.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_upload_ui,node_dashboard_ui,node_report_ui,node_login_ui,node_user_ui,node_router,node_auth_store,node_upload_store,node_http_client,node_person toneBlue
class node_upload_controller,node_upload_service,node_validation,node_python_bridge,node_dashboard_controller,node_dashboard_service,node_analytics_db,node_user_db toneAmber
class node_auth_controller,node_auth_service,node_admin_controller,node_user_service,node_user_repository,node_user_entity toneMint
class node_python_api,node_batch_runner,node_cleaning,node_analysis,node_insights,node_analytics_store toneRose
```

## Components

### Web interface

- [Upload screen](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/views/Upload.vue): `FrontEnd/src/views/Upload.vue`
- [Dashboard screen](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/views/Dashboard.vue): `FrontEnd/src/views/Dashboard.vue`
- [Report screen](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/views/Relatorio.vue): `FrontEnd/src/views/Relatorio.vue`
- [Login screen](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/views/Login.vue): `FrontEnd/src/views/Login.vue`
- [User screen](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/views/Usuario.vue): `FrontEnd/src/views/Usuario.vue`
- [View router](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/router/index.js): `FrontEnd/src/router/index.js`
- [Auth state](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/Stores/auth.js): `FrontEnd/src/Stores/auth.js`
- [Upload state](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/Stores/UploadStore.js): `FrontEnd/src/Stores/UploadStore.js`
- [API client](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/FrontEnd/src/services/api.js): `FrontEnd/src/services/api.js`

### Spring API

- [Upload endpoint](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/controller/UploadController.java): `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/controller/UploadController.java`
- [Upload workflow](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/UploadService.java): `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/UploadService.java`
- [Client validation](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/ClienteValidacaoService.java): `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/ClienteValidacaoService.java`
- [Python ETL bridge](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/PythonEtlService.java): `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/PythonEtlService.java`
- [Dashboard endpoint](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/controller/DashboardController.java): `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/controller/DashboardController.java`
- [Dashboard queries](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/DashboardService.java): `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/DashboardService.java`

### User identity

- [Auth endpoint](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/controller/AuthController.java): `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/controller/AuthController.java`
- [Auth rules](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/AuthService.java): `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/AuthService.java`
- [User administration](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/controller/AdminUsuarioController.java): `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/controller/AdminUsuarioController.java`
- [User management](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/UsuarioService.java): `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/UsuarioService.java`
- [User repository](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/repository/UsuarioRepository.java): `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/repository/UsuarioRepository.java`
- [User account](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/BackEnd/cloud_io/src/main/java/com/senai/cloud_io/model/Usuario.java): `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/model/Usuario.java`

### Data analytics

- [Analytics API](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/CienciaD/api.py): `CienciaD/api.py`
- [Batch processor](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/CienciaD/main.py): `CienciaD/main.py`
- [Data cleaning](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/CienciaD/limpeza.py): `CienciaD/limpeza.py`
- [Statistics](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/CienciaD/analise.py): `CienciaD/analise.py`
- [Insight generation](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/CienciaD/insights.py): `CienciaD/insights.py`
- [Analytics persistence](https://github.com/luciano8383/projeto_cloud_io_systems/blob/main/CienciaD/banco.py): `CienciaD/banco.py`

### Other components

- **User**
- **Analytics database**
- **User database**

## Connections

- User → Upload screen: uploads file
- User → Login screen: signs in
- View router → Upload screen: routes to (evidence: `FrontEnd/src/router/index.js`)
- View router → Dashboard screen: routes to (evidence: `FrontEnd/src/router/index.js`)
- View router → Report screen: routes to (evidence: `FrontEnd/src/router/index.js`)
- View router → Login screen: routes to (evidence: `FrontEnd/src/router/index.js`)
- View router → User screen: routes to (evidence: `FrontEnd/src/router/index.js`)
- Login screen → Auth state: uses auth (evidence: `FrontEnd/src/views/Login.vue`)
- Auth state → API client: sends requests (evidence: `FrontEnd/src/Stores/auth.js`)
- Upload screen → Upload state: uses upload state
- Upload screen → API client: sends upload
- Dashboard screen → API client: requests data
- API client → Upload endpoint: HTTP upload
- API client → Auth endpoint: HTTP auth
- API client → Dashboard endpoint: HTTP dashboard
- Upload endpoint → Upload workflow: delegates to (evidence: `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/UploadService.java`)
- Upload workflow → Client validation: validates rows (evidence: `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/UploadService.java`)
- Upload workflow → Python ETL bridge: invokes ETL (evidence: `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/UploadService.java`)
- Python ETL bridge → Analytics API: submits batch
- Analytics API → Batch processor: dispatches batch (evidence: `CienciaD/api.py`)
- Batch processor → Data cleaning: cleans rows (evidence: `CienciaD/main.py`)
- Batch processor → Statistics: calculates metrics (evidence: `CienciaD/main.py`)
- Statistics → Insight generation: generates insights (evidence: `CienciaD/analise.py`)
- Batch processor → Analytics persistence: writes results (evidence: `CienciaD/main.py`)
- Analytics persistence → Analytics database: persists batch
- Dashboard endpoint → Dashboard queries: delegates to (evidence: `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/controller/DashboardController.java`)
- Dashboard queries → Analytics database: reads results (evidence: `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/DashboardService.java`)
- Auth endpoint → Auth rules: delegates to (evidence: `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/controller/AuthController.java`)
- Auth rules → User repository: reads and saves (evidence: `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/AuthService.java`)
- Auth rules → User account: creates account (evidence: `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/AuthService.java`)
- User administration → User management: delegates to (evidence: `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/controller/AdminUsuarioController.java`)
- User management → User repository: manages users (evidence: `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/service/UsuarioService.java`)
- User repository → User account: stores accounts (evidence: `BackEnd/cloud_io/src/main/java/com/senai/cloud_io/repository/UsuarioRepository.java`)
- User repository → User database: reads and writes
