B. Architecture & organisation du code - uha-fr/endyear_2025_gr11_back GitHub Wiki

Architecture & organisation du code

Organisation du code

Le dossier PROJET-GIT contient une application constituée d’un serveur flask de modules d’analyse, des bases de données et une interface utilisateur.

archeologist/ : API code-archeologist pour l’analyse de dépots - service archeologist-db
archeologist-db/ : la base de données pour stocker les analyses faites par code-archeologist - service archeologist
backend/ : serveur API flask pour centraliser les traitements et flux de données - service api
- - app/modules/ : appel des modules modules d’analyse (archeologist)
- - app/routes/ : routes pour recevoir des demandes depuis le frontend
- - utils/ : fonctions utilitaires
data/ : les données à traiter, fournies par l’utilisateur (au format JSON)
db_init/ : scripts d’initialisation des bases de données
frontend/ : interface utilisateur, mets en forme les données d’analyse - service front

graph TD
    A[PROJET-GIT]
    A --> B{Fichiers racine}
    B --> B1[README.md]
    B --> B2[docker-compose.yml]
    B --> B3[Dockerfile.flask]
    B --> B4[projet_git.sh]
    B --> B5[projet_git_exit.sh]
    B --> B6[projet_git_reset.sh]
    B --> B7[requirements.txt]
    B --> B8[wait-for-it.sh]

    A --> C[archeologist/]
    C --> C1[requirements.txt]
    C --> C2[backend/]
    C2 --> C2_1[app.mjs]
    C2 --> C2_2[Dockerfile.archeologist]
    C2 --> C2_3[eslint.config.js]
    C2 --> C2_4[package-lock.json]
    C2 --> C2_5[package.json]
    C2 --> C2_6[server.mjs]
    C --> C3[frontend/]
    C3 --> C3_1[index.html]
    C3 --> C3_2[package-lock.json]
    C3 --> C3_3[package.json]
    C3 --> C3_4[vite.config.js]
    C3 --> C3_5[public/]
    C3 --> C3_6[src/]
    C3_6 --> C3_6_1[App.vue]
    C3_6 --> C3_6_2[main.js]
    C3_6 --> C3_6_3[style.css]
    C3_6 --> C3_6_4[components/]
    C3_6_4 --> C3_6_4_1[AnalysisDashboard.vue]
    C3_6_4 --> C3_6_4_2[CodebaseHeatmap.vue]
    C3_6_4 --> C3_6_4_3[CommitActivityTimeline.vue]
    C3_6_4 --> C3_6_4_4[CommitQA.vue]
    C3_6_4 --> C3_6_4_5[CommitSummary.vue]
    C3_6_4 --> C3_6_4_6[ContributorStatistics.vue]
    C3_6_4 --> C3_6_4_7[DependencyGraph.vue]
    C3_6_4 --> C3_6_4_8[FileChangeFrequency.vue]
    C3_6_4 --> C3_6_4_9[IssueIntegration.vue]
    C3_6_4 --> C3_6_4_10[SimilarCommits.vue]
    C3_6 --> C3_6_5[store/]
    C3_6_5 --> C3_6_5_1[analysis.js]

    A --> D[archeologist-db/]
    D --> D1[Dockerfile.archeologist-db]

    A --> E[backend/]
    E --> E1[Dockerfile.flask]
    E --> E2[main.py]
    E --> E3[requirements.txt]
    E --> E4[app/]
    E4 --> E4_1[__init__.py]
    E4 --> E4_2[config.py]
    E4 --> E4_3[modules/]
    E4_3 --> E4_3_1[blame.py]
    E4_3 --> E4_3_2[code_archeologist.py]
    E4_3 --> E4_3_3[git_statistic.py]
    E4_3 --> E4_3_4[gitstats.py]
    E4_3 --> E4_3_5[notes_td.py]
    E4_3 --> E4_3_6[repo_analyzer.py]
    E4 --> E4_4[routes/]
    E4_4 --> E4_4_1[analysis.py]
    E4_4 --> E4_4_2[audit.py]
    E4_4 --> E4_4_3[groups.py]
    E4_4 --> E4_4_4[repositories_groups.py]
    E4_4 --> E4_4_5[repositories_students.py]
    E4_4 --> E4_4_6[stats.py]
    E4_4 --> E4_4_7[students.py]
    E4 --> E4_5[utils/]
    E4_5 --> E4_5_1[database.py]
    E4_5 --> E4_5_2[dir_manager.py]
    E4_5 --> E4_5_3[json_to_db.py]
    E4_5 --> E4_5_4[node_analyzer_client.py]
    E --> E5[data/]
    E5 --> E5_1[deadlines.json]
    E5 --> E5_2[groups.json]
    E5 --> E5_3[repositories.json]
    E5 --> E5_4[students.json]

    A --> F[data/]
    F --> F1[deadlines.json]
    F --> F2[groupes.json]
    F --> F3[groups.json]
    F --> F4[lestds.json]
    F --> F5[repos.json]
    F --> F6[repositories.json]
    F --> F7[students.json]
    F --> F8[tds.json]

    A --> G[db_init/]
    G --> G1[before_empty.sql]
    G --> G2[before_modif.sql]
    G --> G3[init-timescaledb.sql]
    G --> G4[init.sql]
    G --> G5[init_____aaaa.sql]
    G --> G6[init_old_1.sql]
    G --> G7[new.sql]

    A --> H[frontend/]
    H --> H1[Dockerfile.front]
    H --> H2[package-lock.json]
    H --> H3[package.json]
    H --> H4[.env]
    H --> H5[public/]
    H5 --> H5_1[index.html]
    H5 --> H5_2[manifest.json]
    H --> H6[src/]
    H6 --> H6_1[App.jsx]
    H6 --> H6_2[index.jsx]
    H6 --> H6_3[assets/]
    H6 --> H6_4[components/]
    H6_4 --> H6_4_1[AuditDisplay.jsx]
    H6_4 --> H6_4_2[Dashboard.jsx]
    H6_4 --> H6_4_3[GroupAnalysis.jsx]
    H6_4 --> H6_4_4[GroupList.jsx]
    H6_4 --> H6_4_5[StudentForm.jsx]
    H6_4 --> H6_4_6[StudentList.jsx]
    H6_4 --> H6_4_7[StudentProfile.jsx]
    H6_4 --> H6_4_8[Toolbar.jsx]
    H6 --> H6_5[graphs/]
    H6_5 --> H6_5_1[BlameChartEvolution.jsx]
    H6_5 --> H6_5_2[ClassScore.jsx]
    H6_5 --> H6_5_3[CodeEvolution.jsx]
    H6_5 --> H6_5_4[CommitActivityTimeline.jsx]
    H6_5 --> H6_5_5[CommitsChart.jsx]
    H6_5 --> H6_5_6[FileChangeFrequencyGraph.jsx]
    H6_5 --> H6_5_7[HeatMapFileChanges.jsx]
    H6 --> H6_6[scriptDB/]
    H6_6 --> H6_6_1["gitanalyser(2).sql"]
    H6 --> H6_7[style/]
    H6_7 --> H6_7_1[App.css]
    H6_7 --> H6_7_2[AuditResultsDisplay.css]
    H6_7 --> H6_7_3[Dashboard.css]
    H6_7 --> H6_7_4[Graphs.css]
    H6_7 --> H6_7_5[GroupAnalysis.css]
    H6_7 --> H6_7_6[GroupList.css]
    H6_7 --> H6_7_7[MainComponents.css]
    H6_7 --> H6_7_8[StudentList.css]
    H6_7 --> H6_7_9[StudentProfile.css]
    H6_7 --> H6_7_10[Toolbar.css]
    H6 --> H6_8[utils/]
    H6_8 --> H6_8_1[stringUtils.jsx]

    A --> I[json_utils/]
    I --> I1[deadlines.json]

└── PROJET-GIT

├── README.md

├── docker-compose.yml

├── Dockerfile.flask

├── projet_git.sh

├── projet_git_exit.sh

├── projet_git_reset.sh

├── requirements.txt

├── wait-for-it.sh

├── archeologist/

│ ├── requirements.txt

│ ├── backend/

│ │ ├── app.mjs

│ │ ├── Dockerfile.archeologist

│ │ ├── eslint.config.js

│ │ ├── package-lock.json

│ │ ├── package.json

│ │ └── server.mjs

│ └── frontend/

│ ├── index.html

│ ├── package-lock.json

│ ├── package.json

│ ├── vite.config.js

│ ├── public/

│ └── src/

│ ├── App.vue

│ ├── main.js

│ ├── style.css

│ ├── components/

│ │ ├── AnalysisDashboard.vue

│ │ ├── CodebaseHeatmap.vue

│ │ ├── CommitActivityTimeline.vue

│ │ ├── CommitQA.vue

│ │ ├── CommitSummary.vue

│ │ ├── ContributorStatistics.vue

│ │ ├── DependencyGraph.vue

│ │ ├── FileChangeFrequency.vue

│ │ ├── IssueIntegration.vue

│ │ └── SimilarCommits.vue

│ └── store/

│ └── analysis.js

├── archeologist-db/

│ └── Dockerfile.archeologist-db

├── backend/

│ ├── Dockerfile.flask

│ ├── main.py

│ ├── requirements.txt

│ ├── app/

│ │ ├── __init__.py

│ │ ├── config.py

│ │ ├── modules/

│ │ │ ├── blame.py

│ │ │ ├── code_archeologist.py

│ │ │ ├── git_statistic.py

│ │ │ ├── gitstats.py

│ │ │ ├── notes_td.py

│ │ │ └── repo_analyzer.py

│ │ ├── routes/

│ │ │ ├── analysis.py

│ │ │ ├── audit.py

│ │ │ ├── groups.py

│ │ │ ├── repositories_groups.py

│ │ │ ├── repositories_students.py

│ │ │ ├── stats.py

│ │ │ └── students.py

│ │ └── utils/

│ │ ├── database.py

│ │ ├── dir_manager.py

│ │ ├── json_to_db.py

│ │ └── node_analyzer_client.py

│ └── data/

│ ├── deadlines.json

│ ├── groups.json

│ ├── repositories.json

│ └── students.json

├── data/

│ ├── deadlines.json

│ ├── groupes.json

│ ├── groups.json

│ ├── lestds.json

│ ├── repos.json

│ ├── repositories.json

│ ├── students.json

│ └── tds.json

├── db_init/

│ ├── before_empty.sql

│ ├── before_modif.sql

│ ├── init-timescaledb.sql

│ ├── init.sql

│ ├── init_____aaaa.sql

│ ├── init_old_1.sql

│ └── new.sql

├── frontend/

│ ├── Dockerfile.front

│ ├── package-lock.json

│ ├── package.json

│ ├── .env

│ ├── public/

│ │ ├── index.html

│ │ └── manifest.json

│ └── src/

│ ├── App.jsx

│ ├── index.jsx

│ ├── assets/

│ ├── components/

│ │ ├── AuditDisplay.jsx

│ │ ├── Dashboard.jsx

│ │ ├── GroupAnalysis.jsx

│ │ ├── GroupList.jsx

│ │ ├── StudentForm.jsx

│ │ ├── StudentList.jsx

│ │ ├── StudentProfile.jsx

│ │ └── Toolbar.jsx

│ ├── graphs/

│ │ ├── BlameChartEvolution.jsx

│ │ ├── ClassScore.jsx

│ │ ├── CodeEvolution.jsx

│ │ ├── CommitActivityTimeline.jsx

│ │ ├── CommitsChart.jsx

│ │ ├── FileChangeFrequencyGraph.jsx

│ │ └── HeatMapFileChanges.jsx

│ ├── scriptDB/

│ │ └── gitanalyser(2).sql

│ ├── style/

│ │ ├── App.css

│ │ ├── AuditResultsDisplay.css

│ │ ├── Dashboard.css

│ │ ├── Graphs.css

│ │ ├── GroupAnalysis.css

│ │ ├── GroupList.css

│ │ ├── MainComponents.css

│ │ ├── StudentList.css

│ │ ├── StudentProfile.css

│ │ └── Toolbar.css

│ └── utils/

│ └── stringUtils.jsx

└── json_utils/

└── deadlines.json

Containers

Chaque service aura son container dédié dans lequel seront copiés les fichiers qui lui sont relatif :

projet-git-archeologist-1
projet-git-archeologist-db
projet-git-front-1
projet-git-db-1
projet-git-api-1

Pour y accéder et effectuer des commandes dessus : docker exec -it projet-git-db-1 bash

Volumes

Les données persistantes seront stockées dans des volumes montée dans l’image docker :

projet-git-archeologist-data : données d’analyses persistantes stockées dans archeologist-db. Accessibles depuis le service archeologist sur : /home/postgres/pgdata/data
projet-git-mysql-data : données persistantes extraites des fichiers JSON fournies par l’utilisateur. Accessible depuis le service db sur : /var/lib/mysql
projet-git-repo : stockage des clones des dépots analysés. Accessible depuis les services api et archeologist sur : /app/clones

Audit automatique d’un dépôt Git(GitHub/GitLab) :

Nombre de commits, répartition par auteur, co-modifications.
Fichiers les plus modifiés.
Complexité cyclomatique de chaque fichier.
Contributions en ligne (ajouts/suppressions).
Évolution temporelle (graphique + deadline).
Rapport HTML complet GitStats.

Statistiques de classe pour un ensemble de dépôts d’étudiants :

Analyse TD par TD (commits le samedi, score, à l’heure ou non).
Score global par étudiant.
Tableaux et graphiques consolidés.
Détection de patterns de code communs entre tous les TDs.
Intégration API GitHub : branches, PR, issues, reviews, CI/CD.