# caiogabdev/projetoindividualcti architecture

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

- Interactive diagram: https://gitdiagram.com/caiogabdev/projetoindividualcti
- Repository: https://github.com/caiogabdev/projetoindividualcti

## Overview

Âncora is a commercial-insights application: users authenticate, upload and validate a client spreadsheet, then view client records, dashboard statistics, and upload reports. The Vue frontend calls a documented Spring Boot API; that backend sends upload batches to the Python ETL, which cleans and analyzes the rows and persists results in PostgreSQL. The excerpts establish the ETL’s internal call order and the frontend’s API boundary; backend implementation details and some page behavior are not sampled, so those links are omitted or shown as unverified where appropriate.

Main entry points: [`FrontEnd/src/router/index.js`](https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/router/index.js) (Routes and guards), [`FrontEnd/src/services/api.js`](https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/services/api.js) (HTTP API client), [`FrontEnd/src/views/Clientes.vue`](https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/views/Clientes.vue) (Client portfolio), [`analytics-python/main.py`](https://github.com/caiogabdev/projetoindividualcti/blob/main/analytics-python/main.py) (Batch orchestrator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Vue application"]
  node_app["Vue app bootstrap<br/>[main.js]"]
  node_router["Routes and guards<br/>[index.js]"]
  node_upload["Spreadsheet upload<br/>[Upload.vue]"]
  node_clients["Client portfolio<br/>[Clientes.vue]"]
  node_dashboard["Analytics dashboard<br/>[Dashboard.vue]"]
  node_report["Validation report<br/>[Relatorio.vue]"]
  node_settings["Account settings<br/>[Configuracoes.vue]"]
end

subgraph group_etl["Python ETL"]
  node_pyapi["ETL API entry<br/>[api.py]"]
  node_pipeline["Batch orchestrator<br/>[main.py]"]
  node_clean["Row cleaning<br/>[limpeza.py]"]
  node_analysis["Statistical analysis<br/>[analise.py]"]
  node_insights["Insight generation<br/>[insights.py]"]
end

subgraph group_persistence["Data persistence"]
  node_dbaccess["Persistence operations<br/>[banco.py]"]
  node_config["Database configuration<br/>[config.py]"]
end

subgraph group_shared["Shared frontend services"]
  node_auth["Auth state<br/>[auth.js]"]
  node_uploadstate["Upload state<br/>[uploadStore.js]"]
  node_api["HTTP API client<br/>[api.js]"]
  node_format["Data formatting<br/>[formatar.js]"]
  node_export["Report export<br/>[exportar.js]"]
end

node_user(("User"))
node_spring{{"Spring Boot API"}}
node_postgres[("PostgreSQL")]

node_user -->|"uses"| node_app
node_app -->|"installs routes"| node_router
node_router -->|"checks session"| node_auth
node_router -->|"routes to"| node_upload
node_router -->|"routes to"| node_clients
node_router -->|"routes to"| node_dashboard
node_router -->|"routes to"| node_report
node_router -->|"routes to"| node_settings
node_auth -->|"calls auth endpoints"| node_api
node_upload -->|"submits batches"| node_api
node_upload -->|"uses upload state"| node_uploadstate
node_clients -->|"loads client data"| node_api
node_clients -->|"formats values"| node_format
node_clients -->|"exports data"| node_export
node_dashboard -->|"requests dashboard"| node_api
node_report -->|"reads upload results"| node_uploadstate
node_report -->|"exports report"| node_export
node_settings -->|"updates account"| node_api
node_api -->|"sends HTTP requests"| node_spring
node_spring -->|"sends upload batch"| node_pyapi
node_pyapi -->|"dispatches batch"| node_pipeline
node_pipeline -->|"reserves and saves"| node_dbaccess
node_pipeline -->|"cleans rows"| node_clean
node_pipeline -->|"calculates statistics"| node_analysis
node_analysis -->|"uses insight helpers"| node_insights
node_dbaccess -->|"writes batch results"| node_postgres
node_dbaccess -->|"uses connection settings"| node_config
node_spring -.->|"serves persisted data"| node_postgres

click node_app "https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/main.js"
click node_router "https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/router/index.js"
click node_auth "https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/stores/auth.js"
click node_upload "https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/views/Upload.vue"
click node_uploadstate "https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/stores/uploadStore.js"
click node_clients "https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/views/Clientes.vue"
click node_dashboard "https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/views/Dashboard.vue"
click node_report "https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/views/Relatorio.vue"
click node_settings "https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/views/Configuracoes.vue"
click node_api "https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/services/api.js"
click node_format "https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/services/formatar.js"
click node_export "https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/services/exportar.js"
click node_pyapi "https://github.com/caiogabdev/projetoindividualcti/blob/main/analytics-python/api.py"
click node_pipeline "https://github.com/caiogabdev/projetoindividualcti/blob/main/analytics-python/main.py"
click node_clean "https://github.com/caiogabdev/projetoindividualcti/blob/main/analytics-python/limpeza.py"
click node_analysis "https://github.com/caiogabdev/projetoindividualcti/blob/main/analytics-python/analise.py"
click node_insights "https://github.com/caiogabdev/projetoindividualcti/blob/main/analytics-python/insights.py"
click node_dbaccess "https://github.com/caiogabdev/projetoindividualcti/blob/main/analytics-python/banco.py"
click node_config "https://github.com/caiogabdev/projetoindividualcti/blob/main/analytics-python/config.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_app,node_router,node_upload,node_clients,node_dashboard,node_report,node_settings,node_user toneBlue
class node_pyapi,node_pipeline,node_clean,node_analysis,node_insights,node_postgres toneAmber
class node_dbaccess,node_config,node_spring toneMint
class node_auth,node_uploadstate,node_api,node_format,node_export toneRose
```

## Components

### Vue application

- [Vue app bootstrap](https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/main.js): `FrontEnd/src/main.js`
- [Routes and guards](https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/router/index.js): `FrontEnd/src/router/index.js`
- [Spreadsheet upload](https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/views/Upload.vue): `FrontEnd/src/views/Upload.vue`
- [Client portfolio](https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/views/Clientes.vue): `FrontEnd/src/views/Clientes.vue`
- [Analytics dashboard](https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/views/Dashboard.vue): `FrontEnd/src/views/Dashboard.vue`
- [Validation report](https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/views/Relatorio.vue): `FrontEnd/src/views/Relatorio.vue`
- [Account settings](https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/views/Configuracoes.vue): `FrontEnd/src/views/Configuracoes.vue`

### Python ETL

- [ETL API entry](https://github.com/caiogabdev/projetoindividualcti/blob/main/analytics-python/api.py): `analytics-python/api.py`
- [Batch orchestrator](https://github.com/caiogabdev/projetoindividualcti/blob/main/analytics-python/main.py): `analytics-python/main.py`
- [Row cleaning](https://github.com/caiogabdev/projetoindividualcti/blob/main/analytics-python/limpeza.py): `analytics-python/limpeza.py`
- [Statistical analysis](https://github.com/caiogabdev/projetoindividualcti/blob/main/analytics-python/analise.py): `analytics-python/analise.py`
- [Insight generation](https://github.com/caiogabdev/projetoindividualcti/blob/main/analytics-python/insights.py): `analytics-python/insights.py`

### Data persistence

- [Persistence operations](https://github.com/caiogabdev/projetoindividualcti/blob/main/analytics-python/banco.py): `analytics-python/banco.py`
- [Database configuration](https://github.com/caiogabdev/projetoindividualcti/blob/main/analytics-python/config.py): `analytics-python/config.py`

### Shared frontend services

- [Auth state](https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/stores/auth.js): `FrontEnd/src/stores/auth.js`
- [Upload state](https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/stores/uploadStore.js): `FrontEnd/src/stores/uploadStore.js`
- [HTTP API client](https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/services/api.js): `FrontEnd/src/services/api.js`
- [Data formatting](https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/services/formatar.js): `FrontEnd/src/services/formatar.js`
- [Report export](https://github.com/caiogabdev/projetoindividualcti/blob/main/FrontEnd/src/services/exportar.js): `FrontEnd/src/services/exportar.js`

### Other components

- **User**
- **Spring Boot API**
- **PostgreSQL**

## Connections

- User → Vue app bootstrap: uses
- Vue app bootstrap → Routes and guards: installs routes (evidence: `FrontEnd/src/main.js`)
- Routes and guards → Auth state: checks session (evidence: `FrontEnd/src/router/index.js`)
- Routes and guards → Spreadsheet upload: routes to (evidence: `FrontEnd/src/router/index.js`)
- Routes and guards → Client portfolio: routes to (evidence: `FrontEnd/src/router/index.js`)
- Routes and guards → Analytics dashboard: routes to (evidence: `FrontEnd/src/router/index.js`)
- Routes and guards → Validation report: routes to (evidence: `FrontEnd/src/router/index.js`)
- Routes and guards → Account settings: routes to (evidence: `FrontEnd/src/router/index.js`)
- Auth state → HTTP API client: calls auth endpoints (evidence: `FrontEnd/src/stores/auth.js`)
- Spreadsheet upload → HTTP API client: submits batches (evidence: `FrontEnd/src/views/Upload.vue`)
- Spreadsheet upload → Upload state: uses upload state (evidence: `FrontEnd/src/views/Upload.vue`)
- Client portfolio → HTTP API client: loads client data (evidence: `FrontEnd/src/views/Clientes.vue`)
- Client portfolio → Data formatting: formats values (evidence: `FrontEnd/src/views/Clientes.vue`)
- Client portfolio → Report export: exports data (evidence: `FrontEnd/src/views/Clientes.vue`)
- Analytics dashboard → HTTP API client: requests dashboard (evidence: `FrontEnd/src/views/Dashboard.vue`)
- Validation report → Upload state: reads upload results (evidence: `FrontEnd/src/views/Relatorio.vue`)
- Validation report → Report export: exports report (evidence: `FrontEnd/src/views/Relatorio.vue`)
- Account settings → HTTP API client: updates account (evidence: `FrontEnd/src/views/Configuracoes.vue`)
- HTTP API client → Spring Boot API: sends HTTP requests (evidence: `FrontEnd/src/services/api.js`)
- Spring Boot API → ETL API entry: sends upload batch
- ETL API entry → Batch orchestrator: dispatches batch (evidence: `analytics-python/api.py`)
- Batch orchestrator → Persistence operations: reserves and saves (evidence: `analytics-python/main.py`)
- Batch orchestrator → Row cleaning: cleans rows (evidence: `analytics-python/main.py`)
- Batch orchestrator → Statistical analysis: calculates statistics (evidence: `analytics-python/main.py`)
- Statistical analysis → Insight generation: uses insight helpers (evidence: `analytics-python/analise.py`)
- Persistence operations → PostgreSQL: writes batch results (evidence: `analytics-python/banco.py`)
- Persistence operations → Database configuration: uses connection settings (evidence: `analytics-python/banco.py`)
- Spring Boot API → PostgreSQL: serves persisted data
