# couvain/stocksemences architecture

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

- Interactive diagram: https://gitdiagram.com/couvain/stocksemences
- Repository: https://github.com/couvain/stocksemences

## Overview

##### Project type and purpose
- StockSemences is a two-tier, desktop‐based inventory management application written in Java (Swing).
- Its purpose is to let users manage seed stock, plants, families, distributors, and movements in a PostgreSQL database.

##### File structure
- Top-level folders:
- src: Java source code (UI screens, business/domain classes, interfaces, utility widgets)
- lib: external libraries (PostgreSQL JDBC driver, JCalendar)
- jar: packaged application (GraineStock.jar)
- SQL / postgres: database scripts to create and populate the PostgreSQL schema
- Patterns:
- UI layer: Ecran*.java classes (Swing frames/panels)
- Domain/model layer: C*.java classes implementing IObjetMetier or IObjetStock interfaces
- Deployment: single‐machine desktop app connecting over TCP/IP to PostgreSQL on localhost (port 5432).

##### README for additional insights
- Confirms JavaSE-1.6, PostgreSQL 9.4, Swing-based UI, dependencies in lib, and installation scripts.
- No explicit service or middleware layer beyond JDBC.

##### Main components and relationships
a. Presentation Layer (Java Swing UI)
- Dependencies: each screen imports and invokes methods on domain objects (CPlante, CFamillePlante, etc.).
b. Domain Model Layer
- Interfaces: IObjetMetier, IObjetStock define contracts for CRUD operations, stock adjustments, etc.
c. Data Access (JDBC)
- PostgreSQL JDBC driver (postgresql-9.4-1201.jdbc4.jar) as a component used by the domain objects.
- Domain objects internally open JDBC connections, execute SQL (scripts under SQL/ and postgres/).
d. Database
- PostgreSQL instance (port 5432), with schemas and tables created by base_amap.sql, create_database.sql, data_amap_*.sql.
e. External Libraries & Utilities
- JCalendar (jcalendar-1.4.jar) for date-picker widgets in UI
- Utility components: JNumberTextField, StarRater

##### Architectural patterns and design principles
- Two-tier architecture: desktop UI ↔ domain (business logic + data access) ↔ PostgreSQL DB
- Model-View separation: UI screens (View + Controller) call Model classes (C*)
- Use of interfaces (IObjetMetier, IObjetStock) to decouple UI from concrete implementations
- Reusable widgets and table-models (Tableau*.java) to render lists of domain objects

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        EP["EcranPrincipal\n(Swing JFrame)"]:::ui
        EPl["EcranPlante\n(Swing JFrame)"]:::ui
        EFam["EcranFamillePlante\n(Swing JFrame)"]:::ui
        ESem["EcranSemencier\n(Swing JFrame)"]:::ui
        ESS["EcranSaisieStock\n(Swing JFrame)"]:::ui
        ELot["EcranLot\n(Swing JFrame)"]:::ui
        EMod["EcranModifPlante\n(Swing JFrame)"]:::ui
        EBase["EcranBase\n(Swing JFrame)"]:::ui
    end

    %% Domain Model & Data Access
    subgraph "Domain Model & Data Access"
        direction TB
        Interfaces["IObjetMetier\nIObjetStock"]:::domain
        CO["CObjetMetier"]:::domain
        CP["CPlante"]:::domain
        CF["CFamillePlante"]:::domain
        CSe["CSemencier"]:::domain
        CSt["CStock"]:::domain
        CLo["CLotPlante"]:::domain
        CIv["CInventaire"]:::domain
        CMo["CMouvement"]:::domain
        CSeM["CSensMouvement"]:::domain
        CStNb["CStockNbGraines\nCStockNbPlants\nCStockPoids\nCStockLot"]:::domain
        CIvSp["CInventaireNbGraines\nCInventaireNbPlants\nCInventairePoids\nCInventaireLot"]:::domain
        CMoSp["CMouvementNbGraines\nCMouvementNbPlants\nCMouvementPoids\nCMouvementLot"]:::domain
        Utils["JNumberTextField\nStarRater\nTableau*"]:::domain
    end

    %% Libraries and Artifact
    JCal["JCalendar\n(lib/jcalendar-1.4.jar)"]:::lib
    JDBC["PostgreSQL JDBC Driver\n(lib/postgresql-9.4-1201.jdbc4.jar)"]:::lib
    Jar["GraineStock.jar"]:::artifact

    %% Database & Scripts
    subgraph "Database & Scripts"
        direction TB
        DB[(PostgreSQL\nport 5432)]:::db
        ScriptsSQL["SQL/ scripts"]:::script
        ScriptsPG["postgres/ scripts"]:::script
    end

    %% Connections
    EP -->|"uses"| CP
    EPl -->|"uses"| CP
    EFam -->|"uses"| CF
    ESem -->|"uses"| CSe
    ESS -->|"uses"| CSt
    ELot -->|"uses"| CLo
    EMod -->|"uses"| CP
    EBase -->|"uses"| Interfaces

    CP -->|"implements"| Interfaces
    CF -->|"implements"| Interfaces
    CSe -->|"implements"| Interfaces
    CSt -->|"implements"| Interfaces
    CLo -->|"implements"| Interfaces
    CIv -->|"implements"| Interfaces
    CMo -->|"implements"| Interfaces

    CO --> CStNb
    CO --> CIvSp
    CO --> CMoSp

    CP -->|"JDBC over TCP/IP"| JDBC
    CF -->|"JDBC over TCP/IP"| JDBC
    CSe -->|"JDBC over TCP/IP"| JDBC
    CSt -->|"JDBC over TCP/IP"| JDBC
    CLo -->|"JDBC over TCP/IP"| JDBC
    CIv -->|"JDBC over TCP/IP"| JDBC
    CMo -->|"JDBC over TCP/IP"| JDBC

    JDBC -->|"\nexecutes SQL"| DB

    ScriptsSQL --> DB
    ScriptsPG --> DB

    JCal --> EP
    Utils --> EP

    EP -->|packaged into| Jar
    Interfaces -->|packaged into| Jar
    JDBC -->|included in| Jar

    %% Click Events
    click EP "https://github.com/couvain/stocksemences/blob/master/src/EcranPrincipal.java"
    click EPl "https://github.com/couvain/stocksemences/blob/master/src/EcranPlante.java"
    click EFam "https://github.com/couvain/stocksemences/blob/master/src/EcranFamillePlante.java"
    click ESem "https://github.com/couvain/stocksemences/blob/master/src/EcranSemencier.java"
    click ESS "https://github.com/couvain/stocksemences/blob/master/src/EcranSaisieStock.java"
    click ELot "https://github.com/couvain/stocksemences/blob/master/src/EcranLot.java"
    click EMod "https://github.com/couvain/stocksemences/blob/master/src/EcranModifPlante.java"
    click EBase "https://github.com/couvain/stocksemences/blob/master/src/EcranBase.java"
    click Interfaces "https://github.com/couvain/stocksemences/blob/master/src/IObjetMetier.java"
    click Interfaces "https://github.com/couvain/stocksemences/blob/master/src/IObjetStock.java"
    click CO "https://github.com/couvain/stocksemences/blob/master/src/CObjetMetier.java"
    click CP "https://github.com/couvain/stocksemences/blob/master/src/CPlante.java"
    click CF "https://github.com/couvain/stocksemences/blob/master/src/CFamillePlante.java"
    click CSe "https://github.com/couvain/stocksemences/blob/master/src/CSemencier.java"
    click CSt "https://github.com/couvain/stocksemences/blob/master/src/CStock.java"
    click CLo "https://github.com/couvain/stocksemences/blob/master/src/CLotPlante.java"
    click CIv "https://github.com/couvain/stocksemences/blob/master/src/CInventaire.java"
    click CMo "https://github.com/couvain/stocksemences/blob/master/src/CMouvement.java"
    click CSeM "https://github.com/couvain/stocksemences/blob/master/src/CSensMouvement.java"
    click CStNb "https://github.com/couvain/stocksemences/blob/master/src/CStockNbGraines.java"
    click CStNb "https://github.com/couvain/stocksemences/blob/master/src/CStockNbPlants.java"
    click CStNb "https://github.com/couvain/stocksemences/blob/master/src/CStockPoids.java"
    click CStNb "https://github.com/couvain/stocksemences/blob/master/src/CStockLot.java"
    click CIvSp "https://github.com/couvain/stocksemences/blob/master/src/CInventaireNbGraines.java"
    click CIvSp "https://github.com/couvain/stocksemences/blob/master/src/CInventaireNbPlants.java"
    click CIvSp "https://github.com/couvain/stocksemences/blob/master/src/CInventairePoids.java"
    click CIvSp "https://github.com/couvain/stocksemences/blob/master/src/CInventaireLot.java"
    click CMoSp "https://github.com/couvain/stocksemences/blob/master/src/CMouvementNbGraines.java"
    click CMoSp "https://github.com/couvain/stocksemences/blob/master/src/CMouvementNbPlants.java"
    click CMoSp "https://github.com/couvain/stocksemences/blob/master/src/CMouvementPoids.java"
    click CMoSp "https://github.com/couvain/stocksemences/blob/master/src/CMouvementLot.java"
    click Utils "https://github.com/couvain/stocksemences/blob/master/src/JNumberTextField.java"
    click Utils "https://github.com/couvain/stocksemences/blob/master/src/StarRater.java"
    click Utils "https://github.com/couvain/stocksemences/blob/master/src/TableauBase.java"
    click Utils "https://github.com/couvain/stocksemences/blob/master/src/TableauPlantes.java"
    click Utils "https://github.com/couvain/stocksemences/blob/master/src/TableauFamillePlante.java"
    click Utils "https://github.com/couvain/stocksemences/blob/master/src/TableauSemenciers.java"
    click Utils "https://github.com/couvain/stocksemences/blob/master/src/TableauDistributeurs.java"
    click Utils "https://github.com/couvain/stocksemences/blob/master/src/TableauStock.java"
    click Utils "https://github.com/couvain/stocksemences/blob/master/src/TableauInventaire.java"
    click Utils "https://github.com/couvain/stocksemences/blob/master/src/TableauMouvement.java"
    click Utils "https://github.com/couvain/stocksemences/blob/master/src/TableauHistorique.java"

    %% Styles
    classDef ui fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef domain fill:#90EE90,stroke:#000,stroke-width:1px
    classDef db fill:#FFA500,stroke:#000,stroke-width:1px
    classDef lib fill:#D3D3D3,stroke:#000,stroke-width:1px
    classDef script fill:#D3D3D3,stroke:#000,stroke-width:1px
    classDef artifact fill:#F5F5F5,stroke:#000,stroke-width:1px
```
