# kauan-piacente/data-wise-integrative-project architecture

> Architecture diagram of the GitHub repository kauan-piacente/data-wise-integrative-project, 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/kauan-piacente/data-wise-integrative-project
- Repository: https://github.com/kauan-piacente/data-wise-integrative-project

## Overview

This repository implements a client-data analytics product: users upload customer spreadsheets, review validation and processing results, then explore dashboards, insights, reports, and upload history. The Vue application handles navigation and browser state; Java provides authentication, administration, validation, and upload orchestration; Python provides the analytics/ETL side. The source index confirms some cross-module references, but README content is absent and several feature modules were not sampled, so uncertain connections are omitted or marked unverified.

Main entry points: [`analytics-python/main.py`](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/analytics-python/main.py) (ETL orchestration), [`frontend-vue/src/views/Dashboard.vue`](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/frontend-vue/src/views/Dashboard.vue) (Dashboard), [`backend-java/src/main/java/com/senai/backend_java/services/UploadService.java`](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/services/UploadService.java) (Upload orchestration), [`backend-java/src/main/java/com/senai/backend_java/repositories/UsuarioRepository.java`](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/repositories/UsuarioRepository.java) (User repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_router["Routes and access<br/>[index.js]"]
  node_authui["Auth state<br/>[authStore.js]"]
  node_uploadui["Upload state<br/>[uploadStore.js]"]
  node_dashboard["Dashboard<br/>[Dashboard.vue]"]
  node_clientviews["Client views<br/>[Insights.vue]"]
end

subgraph group_backend["Java backend"]
  node_authcontroller["Auth endpoints"]
  node_authservice["Authentication<br/>[AuthService.java]"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_uploadcontroller["Upload endpoints"]
  node_uploadservice["Upload orchestration<br/>[UploadService.java]"]
  node_validation["Client validation"]
  node_pyetl["Python ETL bridge"]
  node_admin["User administration"]
end

subgraph group_analytics["Python analytics"]
  node_pyapi["Analytics API<br/>[api.py]"]
  node_pymain["ETL orchestration<br/>[main.py]"]
  node_cleaning["Data cleaning<br/>[limpeza.py]"]
  node_analysis["Analysis<br/>[analise.py]"]
  node_insights["Insight generation<br/>[insights.py]"]
  node_pystore["Analytics storage<br/>[banco.py]"]
end

subgraph group_data["Domain and persistence"]
  node_userrepo["User repository"]
  node_userentity["User entity<br/>[Usuario.java]"]
  node_uploadrecords[("Upload records<br/>[UploadService.java]")]
end

node_user(("User"))
node_database[("Application database")]

node_user -->|"navigates"| node_router
node_router -->|"checks auth"| node_authui
node_router -->|"routes to"| node_dashboard
node_authui -->|"calls auth API"| node_authcontroller
node_uploadui -->|"submits uploads"| node_uploadcontroller
node_uploadui -->|"fetches batches"| node_pyapi
node_dashboard -->|"uses auth state"| node_authui
node_dashboard -->|"uses upload state"| node_uploadui
node_dashboard -.->|"supports insights"| node_clientviews
node_authcontroller -->|"delegates auth"| node_authservice
node_authcontroller -->|"reads current user"| node_userrepo
node_authservice -->|"reads and saves"| node_userrepo
node_authservice -->|"issues tokens"| node_jwt
node_userrepo -->|"persists users"| node_userentity
node_userentity -->|"maps entity"| node_database
node_admin -.->|"manages users"| node_userrepo
node_uploadcontroller -->|"delegates uploads"| node_uploadservice
node_uploadservice -->|"validates rows"| node_validation
node_uploadservice -->|"sends valid rows"| node_pyetl
node_uploadservice -->|"reads and writes"| node_uploadrecords
node_uploadrecords -->|"stores batches"| node_database
node_pyetl -.->|"invokes analytics"| node_pyapi
node_pymain -->|"calls cleaning"| node_cleaning
node_pymain -->|"calls analysis"| node_analysis
node_pymain -->|"calls insights"| node_insights
node_pymain -->|"uses storage"| node_pystore
node_pystore -.->|"persists analytics"| node_database

click node_router "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/frontend-vue/src/router/index.js"
click node_authui "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/frontend-vue/src/store/authStore.js"
click node_uploadui "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/frontend-vue/src/store/uploadStore.js"
click node_dashboard "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/frontend-vue/src/views/Dashboard.vue"
click node_clientviews "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/frontend-vue/src/views/Insights.vue"
click node_authcontroller "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/controllers/AuthController.java"
click node_authservice "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/services/AuthService.java"
click node_jwt "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/security/JwtService.java"
click node_uploadcontroller "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/controllers/UploadController.java"
click node_uploadservice "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/services/UploadService.java"
click node_validation "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/services/ClienteValidacaoService.java"
click node_pyetl "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/services/PythonEtlService.java"
click node_admin "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/controllers/UsuarioAdminController.java"
click node_userrepo "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/repositories/UsuarioRepository.java"
click node_userentity "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/models/Usuario.java"
click node_uploadrecords "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/services/UploadService.java"
click node_pyapi "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/analytics-python/api.py"
click node_pymain "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/analytics-python/main.py"
click node_cleaning "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/analytics-python/limpeza.py"
click node_analysis "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/analytics-python/analise.py"
click node_insights "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/analytics-python/insights.py"
click node_pystore "https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/analytics-python/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_router,node_authui,node_uploadui,node_dashboard,node_clientviews,node_user toneBlue
class node_authcontroller,node_authservice,node_jwt,node_uploadcontroller,node_uploadservice,node_validation,node_pyetl,node_admin,node_database toneAmber
class node_pyapi,node_pymain,node_cleaning,node_analysis,node_insights,node_pystore toneMint
class node_userrepo,node_userentity,node_uploadrecords toneRose
```

## Components

### Web application

- [Routes and access](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/frontend-vue/src/router/index.js): `frontend-vue/src/router/index.js`
- [Auth state](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/frontend-vue/src/store/authStore.js): `frontend-vue/src/store/authStore.js`
- [Upload state](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/frontend-vue/src/store/uploadStore.js): `frontend-vue/src/store/uploadStore.js`
- [Dashboard](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/frontend-vue/src/views/Dashboard.vue): `frontend-vue/src/views/Dashboard.vue`
- [Client views](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/frontend-vue/src/views/Insights.vue): `frontend-vue/src/views/Insights.vue`

### Java backend

- [Auth endpoints](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/controllers/AuthController.java): `backend-java/src/main/java/com/senai/backend_java/controllers/AuthController.java`
- [Authentication](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/services/AuthService.java): `backend-java/src/main/java/com/senai/backend_java/services/AuthService.java`
- [JWT service](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/security/JwtService.java): `backend-java/src/main/java/com/senai/backend_java/security/JwtService.java`
- [Upload endpoints](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/controllers/UploadController.java): `backend-java/src/main/java/com/senai/backend_java/controllers/UploadController.java`
- [Upload orchestration](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/services/UploadService.java): `backend-java/src/main/java/com/senai/backend_java/services/UploadService.java`
- [Client validation](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/services/ClienteValidacaoService.java): `backend-java/src/main/java/com/senai/backend_java/services/ClienteValidacaoService.java`
- [Python ETL bridge](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/services/PythonEtlService.java): `backend-java/src/main/java/com/senai/backend_java/services/PythonEtlService.java`
- [User administration](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/controllers/UsuarioAdminController.java): `backend-java/src/main/java/com/senai/backend_java/controllers/UsuarioAdminController.java`

### Python analytics

- [Analytics API](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/analytics-python/api.py): `analytics-python/api.py`
- [ETL orchestration](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/analytics-python/main.py): `analytics-python/main.py`
- [Data cleaning](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/analytics-python/limpeza.py): `analytics-python/limpeza.py`
- [Analysis](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/analytics-python/analise.py): `analytics-python/analise.py`
- [Insight generation](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/analytics-python/insights.py): `analytics-python/insights.py`
- [Analytics storage](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/analytics-python/banco.py): `analytics-python/banco.py`

### Domain and persistence

- [User repository](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/repositories/UsuarioRepository.java): `backend-java/src/main/java/com/senai/backend_java/repositories/UsuarioRepository.java`
- [User entity](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/models/Usuario.java): `backend-java/src/main/java/com/senai/backend_java/models/Usuario.java`
- [Upload records](https://github.com/kauan-piacente/data-wise-integrative-project/blob/main/backend-java/src/main/java/com/senai/backend_java/services/UploadService.java): `backend-java/src/main/java/com/senai/backend_java/services/UploadService.java`

### Other components

- **User**
- **Application database**

## Connections

- User → Routes and access: navigates (evidence: `frontend-vue/src/router/index.js`)
- Routes and access → Auth state: checks auth (evidence: `frontend-vue/src/router/index.js`)
- Routes and access → Dashboard: routes to (evidence: `frontend-vue/src/router/index.js`)
- Auth state → Auth endpoints: calls auth API (evidence: `frontend-vue/src/store/authStore.js`)
- Upload state → Upload endpoints: submits uploads (evidence: `frontend-vue/src/store/uploadStore.js`)
- Upload state → Analytics API: fetches batches (evidence: `frontend-vue/src/store/uploadStore.js`)
- Dashboard → Auth state: uses auth state (evidence: `frontend-vue/src/views/Dashboard.vue`)
- Dashboard → Upload state: uses upload state (evidence: `frontend-vue/src/views/Dashboard.vue`)
- Dashboard → Client views: supports insights
- Auth endpoints → Authentication: delegates auth (evidence: `backend-java/src/main/java/com/senai/backend_java/controllers/AuthController.java`)
- Auth endpoints → User repository: reads current user (evidence: `backend-java/src/main/java/com/senai/backend_java/controllers/AuthController.java`)
- Authentication → User repository: reads and saves (evidence: `backend-java/src/main/java/com/senai/backend_java/services/AuthService.java`)
- Authentication → JWT service: issues tokens (evidence: `backend-java/src/main/java/com/senai/backend_java/services/AuthService.java`)
- User repository → User entity: persists users (evidence: `backend-java/src/main/java/com/senai/backend_java/repositories/UsuarioRepository.java`)
- User entity → Application database: maps entity (evidence: `backend-java/src/main/java/com/senai/backend_java/models/Usuario.java`)
- User administration → User repository: manages users
- Upload endpoints → Upload orchestration: delegates uploads (evidence: `backend-java/src/main/java/com/senai/backend_java/controllers/UploadController.java`)
- Upload orchestration → Client validation: validates rows (evidence: `backend-java/src/main/java/com/senai/backend_java/services/UploadService.java`)
- Upload orchestration → Python ETL bridge: sends valid rows (evidence: `backend-java/src/main/java/com/senai/backend_java/services/UploadService.java`)
- Upload orchestration → Upload records: reads and writes (evidence: `backend-java/src/main/java/com/senai/backend_java/services/UploadService.java`)
- Upload records → Application database: stores batches (evidence: `backend-java/src/main/java/com/senai/backend_java/services/UploadService.java`)
- Python ETL bridge → Analytics API: invokes analytics
- ETL orchestration → Data cleaning: calls cleaning (evidence: `analytics-python/main.py`)
- ETL orchestration → Analysis: calls analysis (evidence: `analytics-python/main.py`)
- ETL orchestration → Insight generation: calls insights (evidence: `analytics-python/main.py`)
- ETL orchestration → Analytics storage: uses storage (evidence: `analytics-python/main.py`)
- Analytics storage → Application database: persists analytics
