# gianpaolo-pestilli/dataset architecture

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

- Interactive diagram: https://gitdiagram.com/gianpaolo-pestilli/dataset
- Repository: https://github.com/gianpaolo-pestilli/dataset

## Overview

This Java application extracts Syncope project history, issue data, and SonarCloud metrics; builds and labels a release-based class dataset; produces several rankings; and runs Weka classification and analysis. The principal workflow is configuration-selected through a console interface and controllers. The graph preserves the documented ranking and ML branches. Some subsystem paths and links rely on README descriptions or SOURCE INDEX references; unsampled implementation details are not asserted.

Main entry points: [`dataset_creation/src/main/java/dao/DatasetDAO.java`](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/dao/DatasetDAO.java) (Dataset files), [`dataset_creation/src/main/java/control/RankingController.java`](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/RankingController.java) (Ranking stages), [`dataset_creation/src/main/java/control/DatasetPopulationController.java`](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/DatasetPopulationController.java) (Metric population), [`dataset_creation/src/main/java/control/LabelingController.java`](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/LabelingController.java) (Bug labeling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime and configuration"]
  node_main["Application entry<br/>[Main.java]"]
  node_config["Phase configuration"]
  node_ui["Console interface<br/>[UserInterface.java]"]
  node_controller["App controller<br/>[AppController.java]"]
end

subgraph group_dataset["Dataset construction"]
  node_git["Git history"]
  node_jira["Jira tickets"]
  node_sonar["Sonar metrics"]
  node_release["Release discovery"]
  node_builder["Dataset initialization"]
  node_population["Metric population"]
  node_labeling["Bug labeling"]
  node_classmodel["Class metrics<br/>[Class.java]"]
  node_datasetstore[("Dataset files<br/>[DatasetDAO.java]")]
end

subgraph group_rankings["Class rankings"]
  node_ranking["Ranking stages"]
  node_effort["Effort ranking"]
  node_smell["Smell ranking"]
  node_debt["Debt ranking"]
  node_app_ranking["Applicative ranking"]
end

subgraph group_ml["Machine learning"]
  node_ml["Classifier training<br/>[MLController.java]"]
  node_weka["Weka execution<br/>[WekaWorker.java]"]
  node_partition["Dataset partitioning"]
  node_report["ML reporting"]
  node_whatif["What-if analysis"]
end

node_user(("Operator"))
node_weka_service["Weka library"]

node_user -.->|"starts"| node_main
node_main -.->|"launches"| node_ui
node_config -.->|"selects phase"| node_ui
node_ui -->|"starts"| node_controller
node_controller -.->|"dispatches"| node_release
node_release -->|"reads releases"| node_git
node_release -->|"reads tickets"| node_jira
node_release -->|"delegates"| node_builder
node_builder -->|"reads history"| node_git
node_builder -->|"reads metrics"| node_sonar
node_builder -->|"writes data"| node_datasetstore
node_population -->|"reads history"| node_git
node_population -->|"reads tickets"| node_jira
node_population -->|"updates dataset"| node_datasetstore
node_population -->|"updates metrics"| node_classmodel
node_labeling -->|"reads commits"| node_git
node_labeling -->|"matches tickets"| node_jira
node_labeling -->|"writes labels"| node_datasetstore
node_labeling -->|"labels classes"| node_classmodel
node_ranking -->|"reads metrics"| node_sonar
node_ranking -.->|"delegates"| node_effort
node_ranking -.->|"delegates"| node_smell
node_ranking -.->|"delegates"| node_debt
node_ranking -.->|"delegates"| node_app_ranking
node_app_ranking -->|"reads classes"| node_datasetstore
node_ml -.->|"runs experiments"| node_weka
node_weka -.->|"uses"| node_weka_service
node_partition -.->|"partitions data"| node_datasetstore
node_report -.->|"reports results"| node_weka
node_whatif -->|"analyzes results"| node_weka
node_whatif -->|"reads datasets"| node_datasetstore

click node_main "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/start/Main.java"
click node_config "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/settings/PropertiesSetter.java"
click node_ui "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/boundary/UserInterface.java"
click node_controller "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/AppController.java"
click node_git "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/boundary/api/GitInteraction.java"
click node_jira "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/boundary/api/JiraInteraction.java"
click node_sonar "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/boundary/api/SonarCloudInteraction.java"
click node_release "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/DatasetController.java"
click node_builder "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/DatasetBuilderController.java"
click node_population "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/DatasetPopulationController.java"
click node_labeling "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/LabelingController.java"
click node_classmodel "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/entity/Class.java"
click node_datasetstore "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/dao/DatasetDAO.java"
click node_ranking "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/RankingController.java"
click node_effort "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/EffortRankingController.java"
click node_smell "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/SmellRankingController.java"
click node_debt "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/DebtRankingController.java"
click node_app_ranking "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/ApplicativeRankingController.java"
click node_ml "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/MLController.java"
click node_weka "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/entity/WekaWorker.java"
click node_partition "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/MLDataController.java"
click node_report "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/MLReportingController.java"
click node_whatif "https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/WhatIfController.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_main,node_config,node_ui,node_controller toneBlue
class node_git,node_jira,node_sonar,node_release,node_builder,node_population,node_labeling,node_classmodel,node_datasetstore toneAmber
class node_ranking,node_effort,node_smell,node_debt,node_app_ranking toneMint
class node_ml,node_weka,node_partition,node_report,node_whatif toneRose
class node_user,node_weka_service toneIndigo
```

## Components

### Runtime and configuration

- [Application entry](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/start/Main.java): `dataset_creation/src/main/java/start/Main.java`
- [Phase configuration](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/settings/PropertiesSetter.java): `dataset_creation/src/main/java/settings/PropertiesSetter.java`
- [Console interface](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/boundary/UserInterface.java): `dataset_creation/src/main/java/boundary/UserInterface.java`
- [App controller](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/AppController.java): `dataset_creation/src/main/java/control/AppController.java`

### Dataset construction

- [Git history](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/boundary/api/GitInteraction.java): `dataset_creation/src/main/java/boundary/api/GitInteraction.java`
- [Jira tickets](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/boundary/api/JiraInteraction.java): `dataset_creation/src/main/java/boundary/api/JiraInteraction.java`
- [Sonar metrics](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/boundary/api/SonarCloudInteraction.java): `dataset_creation/src/main/java/boundary/api/SonarCloudInteraction.java`
- [Release discovery](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/DatasetController.java): `dataset_creation/src/main/java/control/DatasetController.java`
- [Dataset initialization](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/DatasetBuilderController.java): `dataset_creation/src/main/java/control/DatasetBuilderController.java`
- [Metric population](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/DatasetPopulationController.java): `dataset_creation/src/main/java/control/DatasetPopulationController.java`
- [Bug labeling](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/LabelingController.java): `dataset_creation/src/main/java/control/LabelingController.java`
- [Class metrics](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/entity/Class.java): `dataset_creation/src/main/java/entity/Class.java`
- [Dataset files](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/dao/DatasetDAO.java): `dataset_creation/src/main/java/dao/DatasetDAO.java`

### Class rankings

- [Ranking stages](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/RankingController.java): `dataset_creation/src/main/java/control/RankingController.java`
- [Effort ranking](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/EffortRankingController.java): `dataset_creation/src/main/java/control/EffortRankingController.java`
- [Smell ranking](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/SmellRankingController.java): `dataset_creation/src/main/java/control/SmellRankingController.java`
- [Debt ranking](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/DebtRankingController.java): `dataset_creation/src/main/java/control/DebtRankingController.java`
- [Applicative ranking](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/ApplicativeRankingController.java): `dataset_creation/src/main/java/control/ApplicativeRankingController.java`

### Machine learning

- [Classifier training](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/MLController.java): `dataset_creation/src/main/java/control/MLController.java`
- [Weka execution](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/entity/WekaWorker.java): `dataset_creation/src/main/java/entity/WekaWorker.java`
- [Dataset partitioning](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/MLDataController.java): `dataset_creation/src/main/java/control/MLDataController.java`
- [ML reporting](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/MLReportingController.java): `dataset_creation/src/main/java/control/MLReportingController.java`
- [What-if analysis](https://github.com/gianpaolo-pestilli/dataset/blob/main/dataset_creation/src/main/java/control/WhatIfController.java): `dataset_creation/src/main/java/control/WhatIfController.java`

### Other components

- **Operator**
- **Weka library**

## Connections

- Operator → Application entry: starts (evidence: `README.md`)
- Application entry → Console interface: launches
- Phase configuration → Console interface: selects phase (evidence: `README.md`)
- Console interface → App controller: starts (evidence: `dataset_creation/src/main/java/boundary/UserInterface.java`)
- App controller → Release discovery: dispatches (evidence: `dataset_creation/src/main/java/control/DatasetController.java`)
- Release discovery → Git history: reads releases (evidence: `dataset_creation/src/main/java/control/DatasetController.java`)
- Release discovery → Jira tickets: reads tickets (evidence: `dataset_creation/src/main/java/control/DatasetController.java`)
- Release discovery → Dataset initialization: delegates (evidence: `dataset_creation/src/main/java/control/DatasetController.java`)
- Dataset initialization → Git history: reads history (evidence: `dataset_creation/src/main/java/control/DatasetBuilderController.java`)
- Dataset initialization → Sonar metrics: reads metrics (evidence: `dataset_creation/src/main/java/control/DatasetBuilderController.java`)
- Dataset initialization → Dataset files: writes data (evidence: `dataset_creation/src/main/java/control/DatasetBuilderController.java`)
- Metric population → Git history: reads history (evidence: `dataset_creation/src/main/java/control/DatasetPopulationController.java`)
- Metric population → Jira tickets: reads tickets (evidence: `dataset_creation/src/main/java/control/DatasetPopulationController.java`)
- Metric population → Dataset files: updates dataset (evidence: `dataset_creation/src/main/java/control/DatasetPopulationController.java`)
- Metric population → Class metrics: updates metrics (evidence: `dataset_creation/src/main/java/control/DatasetPopulationController.java`)
- Bug labeling → Git history: reads commits (evidence: `dataset_creation/src/main/java/control/LabelingController.java`)
- Bug labeling → Jira tickets: matches tickets (evidence: `dataset_creation/src/main/java/control/LabelingController.java`)
- Bug labeling → Dataset files: writes labels (evidence: `dataset_creation/src/main/java/control/LabelingController.java`)
- Bug labeling → Class metrics: labels classes (evidence: `dataset_creation/src/main/java/control/LabelingController.java`)
- Ranking stages → Sonar metrics: reads metrics (evidence: `dataset_creation/src/main/java/control/RankingController.java`)
- Ranking stages → Effort ranking: delegates
- Ranking stages → Smell ranking: delegates
- Ranking stages → Debt ranking: delegates
- Ranking stages → Applicative ranking: delegates
- Applicative ranking → Dataset files: reads classes (evidence: `dataset_creation/src/main/java/control/ApplicativeRankingController.java`)
- Classifier training → Weka execution: runs experiments (evidence: `dataset_creation/src/main/java/control/MLController.java`)
- Weka execution → Weka library: uses
- Dataset partitioning → Dataset files: partitions data (evidence: `README.md`)
- ML reporting → Weka execution: reports results (evidence: `README.md`)
- What-if analysis → Weka execution: analyzes results (evidence: `dataset_creation/src/main/java/control/WhatIfController.java`)
- What-if analysis → Dataset files: reads datasets (evidence: `dataset_creation/src/main/java/control/WhatIfController.java`)
