# recheraphael-re/cti_senai architecture

> Architecture diagram of the GitHub repository recheraphael-re/cti_senai, 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/recheraphael-re/cti_senai
- Repository: https://github.com/recheraphael-re/cti_senai

## Overview

CTI Provedor is a client-management and analytics application. Users authenticate, manage clients and related service contracts, upload spreadsheet data for ETL and analysis, then view dashboard and report outputs. The tree also shows user administration, validation, telemetry, insights, and service-execution capabilities. Backend controller-to-service links and several UI routes are not established by the sampled excerpts or index references, so those connections are omitted rather than inferred; the Python analytics API’s imports and the sampled service calls provide the clearest internal flow.

Main entry points: [`BackEnd/src/main/java/com/cti/provedor/service/AuthService.java`](https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/service/AuthService.java) (Auth rules), [`FrontEnd/src/main.js`](https://github.com/recheraphael-re/cti_senai/blob/main/FrontEnd/src/main.js) (Vue app), [`FrontEnd/src/stores/auth.js`](https://github.com/recheraphael-re/cti_senai/blob/main/FrontEnd/src/stores/auth.js) (Auth state), [`BackEnd/src/main/java/com/cti/provedor/controller/UploadController.java`](https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/controller/UploadController.java) (Upload endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Vue app<br/>[main.js]"]
  node_router["Routes<br/>[index.js]"]
  node_loginview["Login and signup<br/>[LoginView.vue]"]
  node_uploadview["Upload view<br/>[UploadView.vue]"]
  node_dashviews["Reports and charts<br/>[RelatoriosView.vue]"]
  node_api["API client<br/>[api.js]"]
end

subgraph group_identity["Identity and access"]
  node_authstore["Auth state<br/>[auth.js]"]
  node_authcontroller["Auth endpoints"]
  node_authservice["Auth rules<br/>[AuthService.java]"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_userrepo["User repository"]
  node_admin["User administration"]
end

subgraph group_crm["Client operations"]
  node_clientops["Client management"]
  node_clientmodel["Client records<br/>[Cliente.java]"]
  node_integrator["Service execution"]
  node_servicecontroller["Service endpoints"]
  node_validation["Client validation"]
  node_telemetry["Telemetry endpoints"]
end

subgraph group_data["Data and analytics"]
  node_uploadcontroller["Upload endpoints"]
  node_uploadservice["Upload processing<br/>[UploadService.java]"]
  node_etl["Python ETL bridge"]
  node_pyapi["Analytics API<br/>[api.py]"]
  node_clean["Data cleaning<br/>[limpeza.py]"]
  node_analysis["Statistics<br/>[analise.py]"]
  node_insights["Insights<br/>[insights.py]"]
  node_dashboard["Dashboard service"]
end

node_person(("User"))

node_app -->|"installs"| node_router
node_app -->|"watches session"| node_authstore
node_person -.->|"uses"| node_app
node_router -->|"checks access"| node_authstore
node_authstore -->|"calls"| node_api
node_authcontroller -->|"delegates"| node_authservice
node_authservice -->|"reads and saves"| node_userrepo
node_authservice -->|"issues token"| node_jwt
node_uploadcontroller -->|"delegates"| node_uploadservice
node_uploadcontroller -->|"invokes"| node_etl
node_pyapi -->|"transforms"| node_clean
node_pyapi -->|"calculates"| node_analysis
node_analysis -->|"generates"| node_insights
node_clientops -->|"creates and updates"| node_clientmodel
node_integrator -.->|"exposes operations"| node_servicecontroller

click node_app "https://github.com/recheraphael-re/cti_senai/blob/main/FrontEnd/src/main.js"
click node_router "https://github.com/recheraphael-re/cti_senai/blob/main/FrontEnd/src/router/index.js"
click node_loginview "https://github.com/recheraphael-re/cti_senai/blob/main/FrontEnd/src/views/LoginView.vue"
click node_uploadview "https://github.com/recheraphael-re/cti_senai/blob/main/FrontEnd/src/views/UploadView.vue"
click node_dashviews "https://github.com/recheraphael-re/cti_senai/blob/main/FrontEnd/src/views/RelatoriosView.vue"
click node_authstore "https://github.com/recheraphael-re/cti_senai/blob/main/FrontEnd/src/stores/auth.js"
click node_api "https://github.com/recheraphael-re/cti_senai/blob/main/FrontEnd/src/services/api.js"
click node_authcontroller "https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/controller/AuthController.java"
click node_authservice "https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/service/AuthService.java"
click node_jwt "https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/config/JwtService.java"
click node_userrepo "https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/repository/UsuarioRepository.java"
click node_uploadcontroller "https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/controller/UploadController.java"
click node_uploadservice "https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/service/UploadService.java"
click node_etl "https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/service/PythonEtlService.java"
click node_pyapi "https://github.com/recheraphael-re/cti_senai/blob/main/analytics-python/api.py"
click node_clean "https://github.com/recheraphael-re/cti_senai/blob/main/analytics-python/limpeza.py"
click node_analysis "https://github.com/recheraphael-re/cti_senai/blob/main/analytics-python/analise.py"
click node_insights "https://github.com/recheraphael-re/cti_senai/blob/main/analytics-python/insights.py"
click node_clientops "https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/service/ClienteService.java"
click node_clientmodel "https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/model/Cliente.java"
click node_integrator "https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/service/IntegradorService.java"
click node_servicecontroller "https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/controller/ServicoController.java"
click node_admin "https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/controller/AdminUsuarioController.java"
click node_validation "https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/service/ClienteValidacaoService.java"
click node_dashboard "https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/service/DashboardService.java"
click node_telemetry "https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/controller/TelemetriaController.java"

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_app,node_router,node_loginview,node_uploadview,node_dashviews,node_api,node_person toneBlue
class node_authstore,node_authcontroller,node_authservice,node_jwt,node_userrepo,node_admin toneAmber
class node_clientops,node_clientmodel,node_integrator,node_servicecontroller,node_validation,node_telemetry toneMint
class node_uploadcontroller,node_uploadservice,node_etl,node_pyapi,node_clean,node_analysis,node_insights,node_dashboard toneRose
```

## Components

### Web application

- [Vue app](https://github.com/recheraphael-re/cti_senai/blob/main/FrontEnd/src/main.js): `FrontEnd/src/main.js`
- [Routes](https://github.com/recheraphael-re/cti_senai/blob/main/FrontEnd/src/router/index.js): `FrontEnd/src/router/index.js`
- [Login and signup](https://github.com/recheraphael-re/cti_senai/blob/main/FrontEnd/src/views/LoginView.vue): `FrontEnd/src/views/LoginView.vue`
- [Upload view](https://github.com/recheraphael-re/cti_senai/blob/main/FrontEnd/src/views/UploadView.vue): `FrontEnd/src/views/UploadView.vue`
- [Reports and charts](https://github.com/recheraphael-re/cti_senai/blob/main/FrontEnd/src/views/RelatoriosView.vue): `FrontEnd/src/views/RelatoriosView.vue`
- [API client](https://github.com/recheraphael-re/cti_senai/blob/main/FrontEnd/src/services/api.js): `FrontEnd/src/services/api.js`

### Identity and access

- [Auth state](https://github.com/recheraphael-re/cti_senai/blob/main/FrontEnd/src/stores/auth.js): `FrontEnd/src/stores/auth.js`
- [Auth endpoints](https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/controller/AuthController.java): `BackEnd/src/main/java/com/cti/provedor/controller/AuthController.java`
- [Auth rules](https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/service/AuthService.java): `BackEnd/src/main/java/com/cti/provedor/service/AuthService.java`
- [JWT service](https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/config/JwtService.java): `BackEnd/src/main/java/com/cti/provedor/config/JwtService.java`
- [User repository](https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/repository/UsuarioRepository.java): `BackEnd/src/main/java/com/cti/provedor/repository/UsuarioRepository.java`
- [User administration](https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/controller/AdminUsuarioController.java): `BackEnd/src/main/java/com/cti/provedor/controller/AdminUsuarioController.java`

### Client operations

- [Client management](https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/service/ClienteService.java): `BackEnd/src/main/java/com/cti/provedor/service/ClienteService.java`
- [Client records](https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/model/Cliente.java): `BackEnd/src/main/java/com/cti/provedor/model/Cliente.java`
- [Service execution](https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/service/IntegradorService.java): `BackEnd/src/main/java/com/cti/provedor/service/IntegradorService.java`
- [Service endpoints](https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/controller/ServicoController.java): `BackEnd/src/main/java/com/cti/provedor/controller/ServicoController.java`
- [Client validation](https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/service/ClienteValidacaoService.java): `BackEnd/src/main/java/com/cti/provedor/service/ClienteValidacaoService.java`
- [Telemetry endpoints](https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/controller/TelemetriaController.java): `BackEnd/src/main/java/com/cti/provedor/controller/TelemetriaController.java`

### Data and analytics

- [Upload endpoints](https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/controller/UploadController.java): `BackEnd/src/main/java/com/cti/provedor/controller/UploadController.java`
- [Upload processing](https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/service/UploadService.java): `BackEnd/src/main/java/com/cti/provedor/service/UploadService.java`
- [Python ETL bridge](https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/service/PythonEtlService.java): `BackEnd/src/main/java/com/cti/provedor/service/PythonEtlService.java`
- [Analytics API](https://github.com/recheraphael-re/cti_senai/blob/main/analytics-python/api.py): `analytics-python/api.py`
- [Data cleaning](https://github.com/recheraphael-re/cti_senai/blob/main/analytics-python/limpeza.py): `analytics-python/limpeza.py`
- [Statistics](https://github.com/recheraphael-re/cti_senai/blob/main/analytics-python/analise.py): `analytics-python/analise.py`
- [Insights](https://github.com/recheraphael-re/cti_senai/blob/main/analytics-python/insights.py): `analytics-python/insights.py`
- [Dashboard service](https://github.com/recheraphael-re/cti_senai/blob/main/BackEnd/src/main/java/com/cti/provedor/service/DashboardService.java): `BackEnd/src/main/java/com/cti/provedor/service/DashboardService.java`

### Other components

- **User**

## Connections

- Vue app → Routes: installs (evidence: `FrontEnd/src/main.js`)
- Vue app → Auth state: watches session (evidence: `FrontEnd/src/main.js`)
- User → Vue app: uses
- Routes → Auth state: checks access (evidence: `FrontEnd/src/router/index.js`)
- Auth state → API client: calls (evidence: `FrontEnd/src/stores/auth.js`)
- Auth endpoints → Auth rules: delegates (evidence: `BackEnd/src/main/java/com/cti/provedor/controller/AuthController.java`)
- Auth rules → User repository: reads and saves (evidence: `BackEnd/src/main/java/com/cti/provedor/service/AuthService.java`)
- Auth rules → JWT service: issues token (evidence: `BackEnd/src/main/java/com/cti/provedor/service/AuthService.java`)
- Upload endpoints → Upload processing: delegates (evidence: `BackEnd/src/main/java/com/cti/provedor/controller/UploadController.java`)
- Upload endpoints → Python ETL bridge: invokes (evidence: `BackEnd/src/main/java/com/cti/provedor/controller/UploadController.java`)
- Analytics API → Data cleaning: transforms (evidence: `analytics-python/api.py`)
- Analytics API → Statistics: calculates (evidence: `analytics-python/api.py`)
- Statistics → Insights: generates (evidence: `analytics-python/analise.py`)
- Client management → Client records: creates and updates (evidence: `BackEnd/src/main/java/com/cti/provedor/service/ClienteService.java`)
- Service execution → Service endpoints: exposes operations
