# chafik-akmouche/recherchetabou architecture

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

- Interactive diagram: https://gitdiagram.com/chafik-akmouche/recherchetabou
- Repository: https://github.com/chafik-akmouche/recherchetabou

## Overview

This Java utility package solves sports-league scheduling by creating a tournament fixture, exploring swaps between matches, scoring schedules, and retaining a best solution. The two documented search modes—tabu search and strict descent—are implemented as separate entry points in ChoixMethode. The graph follows calls visible in the excerpts and README; Test.java is named by the source index but not excerpted, so its role and any user-facing invocation are left unspecified.

Main entry points: [`src/fr/univangers/rechercheTabou/utils/ChoixMethode.java`](https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/ChoixMethode.java) (Search methods), [`src/fr/univangers/rechercheTabou/utils/Outils.java`](https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/Outils.java) (Neighborhood tools), [`src/fr/univangers/rechercheTabou/utils/Tournoi.java`](https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/Tournoi.java) (Tournament), [`src/fr/univangers/rechercheTabou/utils/Mouvement.java`](https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/Mouvement.java) (Swap move)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scheduling["Schedule model"]
  node_tournament["Tournament<br/>[Tournoi.java]"]
  node_match["Match<br/>[Match.java]"]
end

subgraph group_search["Search strategies"]
  node_methods["Search methods<br/>[ChoixMethode.java]"]
  node_solution["Best solution<br/>[Solution.java]"]
end

subgraph group_evaluation["Evaluation and moves"]
  node_tools["Neighborhood tools<br/>[Outils.java]"]
  node_move["Swap move<br/>[Mouvement.java]"]
  node_cost["Schedule cost<br/>[Coup.java]"]
end

node_engineer(("User"))

node_engineer -.->|"chooses search"| node_methods
node_methods -->|"accepts schedule"| node_tournament
node_tournament -->|"generates fixtures"| node_match
node_methods -->|"scores schedule"| node_cost
node_methods -->|"explores neighbors"| node_tools
node_tools -->|"returns best swap"| node_move
node_tools -->|"scores neighbors"| node_cost
node_tools -->|"swaps fixtures"| node_tournament
node_methods -->|"applies swap"| node_move
node_methods -->|"records best"| node_solution
node_solution -->|"holds schedule"| node_tournament
node_cost -->|"reads schedule"| node_tournament
node_tools -->|"selects fixtures"| node_match
node_move -->|"pairs fixtures"| node_match

click node_methods "https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/ChoixMethode.java"
click node_tournament "https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/Tournoi.java"
click node_match "https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/Match.java"
click node_tools "https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/Outils.java"
click node_move "https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/Mouvement.java"
click node_cost "https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/Coup.java"
click node_solution "https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/Solution.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_tournament,node_match,node_engineer toneBlue
class node_methods,node_solution toneAmber
class node_tools,node_move,node_cost toneMint
```

## Components

### Schedule model

- [Tournament](https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/Tournoi.java): `src/fr/univangers/rechercheTabou/utils/Tournoi.java`
- [Match](https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/Match.java): `src/fr/univangers/rechercheTabou/utils/Match.java`

### Search strategies

- [Search methods](https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/ChoixMethode.java): `src/fr/univangers/rechercheTabou/utils/ChoixMethode.java`
- [Best solution](https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/Solution.java): `src/fr/univangers/rechercheTabou/utils/Solution.java`

### Evaluation and moves

- [Neighborhood tools](https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/Outils.java): `src/fr/univangers/rechercheTabou/utils/Outils.java`
- [Swap move](https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/Mouvement.java): `src/fr/univangers/rechercheTabou/utils/Mouvement.java`
- [Schedule cost](https://github.com/chafik-akmouche/recherchetabou/blob/master/src/fr/univangers/rechercheTabou/utils/Coup.java): `src/fr/univangers/rechercheTabou/utils/Coup.java`

### Other components

- **User**

## Connections

- User → Search methods: chooses search (evidence: `README.md`)
- Search methods → Tournament: accepts schedule (evidence: `src/fr/univangers/rechercheTabou/utils/ChoixMethode.java`)
- Tournament → Match: generates fixtures (evidence: `src/fr/univangers/rechercheTabou/utils/Tournoi.java`)
- Search methods → Schedule cost: scores schedule (evidence: `src/fr/univangers/rechercheTabou/utils/ChoixMethode.java`)
- Search methods → Neighborhood tools: explores neighbors (evidence: `src/fr/univangers/rechercheTabou/utils/ChoixMethode.java`)
- Neighborhood tools → Swap move: returns best swap (evidence: `src/fr/univangers/rechercheTabou/utils/Outils.java`)
- Neighborhood tools → Schedule cost: scores neighbors (evidence: `src/fr/univangers/rechercheTabou/utils/Outils.java`)
- Neighborhood tools → Tournament: swaps fixtures (evidence: `src/fr/univangers/rechercheTabou/utils/Outils.java`)
- Search methods → Swap move: applies swap (evidence: `src/fr/univangers/rechercheTabou/utils/ChoixMethode.java`)
- Search methods → Best solution: records best (evidence: `src/fr/univangers/rechercheTabou/utils/ChoixMethode.java`)
- Best solution → Tournament: holds schedule (evidence: `src/fr/univangers/rechercheTabou/utils/Solution.java`)
- Schedule cost → Tournament: reads schedule (evidence: `src/fr/univangers/rechercheTabou/utils/Coup.java`)
- Neighborhood tools → Match: selects fixtures (evidence: `src/fr/univangers/rechercheTabou/utils/Outils.java`)
- Swap move → Match: pairs fixtures (evidence: `src/fr/univangers/rechercheTabou/utils/Mouvement.java`)
