# mokhib/javaproj architecture

> Architecture diagram of the GitHub repository mokhib/javaproj, 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/mokhib/javaproj
- Repository: https://github.com/mokhib/javaproj

## Overview

VideoClub is a desktop cinema scheduling and seat-reservation application. The user workflow starts in the Swing window, where staff create films, rooms, and screenings, then select seats and register or cancel reservations; the application can save and reload the cinema state in a local serialized file. The domain model separates programme management from per-screening seat occupancy and reservation accounting. Source excerpts show the window and reservation interactions, but not every programme-panel action, so only evidenced calls are linked.

Main entry points: [`VideoClub/src/videoclub/FenetreCinema.java`](https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/FenetreCinema.java) (Main window), [`VideoClub/src/videoclub/Seance.java`](https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/Seance.java) (Screening), [`VideoClub/src/videoclub/PanneauProgramme.java`](https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/PanneauProgramme.java) (Programme panel), [`VideoClub/src/videoclub/Cinema.java`](https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/Cinema.java) (Cinema catalogue)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_app["Application entry<br/>[VideoClub.java]"]
  node_window["Main window<br/>[FenetreCinema.java]"]
end

subgraph group_catalog["Programme management"]
  node_program_panel["Programme panel"]
  node_cinema[("Cinema catalogue<br/>[Cinema.java]")]
  node_film["Film details<br/>[Film.java]"]
  node_room["Room layout<br/>[Salle.java]"]
  node_screening["Screening<br/>[Seance.java]"]
end

subgraph group_booking["Reservations"]
  node_reservation_panel["Reservation panel"]
  node_seat["Seat<br/>[Place.java]"]
  node_reservation["Reservation record<br/>[Reservation.java]"]
  node_occupied_error["Occupied-seat error"]
end

subgraph group_persistence["Persistence"]
  node_save_service["Save and load<br/>[Sauvegarde.java]"]
  node_local_file[("Local data file<br/>[videoclub.dat]")]
end

node_staff(("Cinema staff"))

node_staff -->|"launches"| node_app
node_app -->|"opens"| node_window
node_staff -->|"uses"| node_window
node_window -->|"shows"| node_program_panel
node_window -->|"shows"| node_reservation_panel
node_window -->|"creates"| node_cinema
node_window -->|"saves and loads"| node_save_service
node_save_service -->|"serializes"| node_local_file
node_program_panel -->|"manages programme"| node_cinema
node_program_panel -->|"creates"| node_film
node_program_panel -->|"creates"| node_room
node_program_panel -->|"creates"| node_screening
node_reservation_panel -->|"reserves seats"| node_cinema
node_reservation_panel -->|"reads occupancy"| node_screening
node_screening -->|"checks layout"| node_room
node_room -->|"provides seats"| node_seat
node_screening -->|"creates and tracks"| node_reservation
node_reservation -->|"records seats"| node_seat
node_screening -->|"throws on conflict"| node_occupied_error
node_cinema -->|"delegates booking"| node_screening

click node_app "https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/VideoClub.java"
click node_window "https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/FenetreCinema.java"
click node_program_panel "https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/PanneauProgramme.java"
click node_reservation_panel "https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/PanneauReservations.java"
click node_cinema "https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/Cinema.java"
click node_film "https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/Film.java"
click node_room "https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/Salle.java"
click node_screening "https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/Seance.java"
click node_seat "https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/Place.java"
click node_reservation "https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/Reservation.java"
click node_occupied_error "https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/PlaceOccupeeException.java"
click node_save_service "https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/Sauvegarde.java"
click node_local_file "https://github.com/mokhib/javaproj/blob/main/VideoClub/videoclub.dat"

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_window toneBlue
class node_program_panel,node_cinema,node_film,node_room,node_screening toneAmber
class node_reservation_panel,node_seat,node_reservation,node_occupied_error toneMint
class node_save_service,node_local_file toneRose
class node_staff toneIndigo
```

## Components

### Desktop interface

- [Application entry](https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/VideoClub.java): `VideoClub/src/videoclub/VideoClub.java`
- [Main window](https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/FenetreCinema.java): `VideoClub/src/videoclub/FenetreCinema.java`

### Programme management

- [Programme panel](https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/PanneauProgramme.java): `VideoClub/src/videoclub/PanneauProgramme.java`
- [Cinema catalogue](https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/Cinema.java): `VideoClub/src/videoclub/Cinema.java`
- [Film details](https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/Film.java): `VideoClub/src/videoclub/Film.java`
- [Room layout](https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/Salle.java): `VideoClub/src/videoclub/Salle.java`
- [Screening](https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/Seance.java): `VideoClub/src/videoclub/Seance.java`

### Reservations

- [Reservation panel](https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/PanneauReservations.java): `VideoClub/src/videoclub/PanneauReservations.java`
- [Seat](https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/Place.java): `VideoClub/src/videoclub/Place.java`
- [Reservation record](https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/Reservation.java): `VideoClub/src/videoclub/Reservation.java`
- [Occupied-seat error](https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/PlaceOccupeeException.java): `VideoClub/src/videoclub/PlaceOccupeeException.java`

### Persistence

- [Save and load](https://github.com/mokhib/javaproj/blob/main/VideoClub/src/videoclub/Sauvegarde.java): `VideoClub/src/videoclub/Sauvegarde.java`
- [Local data file](https://github.com/mokhib/javaproj/blob/main/VideoClub/videoclub.dat): `VideoClub/videoclub.dat`

### Other components

- **Cinema staff**

## Connections

- Cinema staff → Application entry: launches
- Application entry → Main window: opens (evidence: `VideoClub/src/videoclub/VideoClub.java`)
- Cinema staff → Main window: uses (evidence: `VideoClub/src/videoclub/FenetreCinema.java`)
- Main window → Programme panel: shows (evidence: `VideoClub/src/videoclub/FenetreCinema.java`)
- Main window → Reservation panel: shows (evidence: `VideoClub/src/videoclub/FenetreCinema.java`)
- Main window → Cinema catalogue: creates (evidence: `VideoClub/src/videoclub/FenetreCinema.java`)
- Main window → Save and load: saves and loads (evidence: `VideoClub/src/videoclub/FenetreCinema.java`)
- Save and load → Local data file: serializes (evidence: `VideoClub/src/videoclub/Sauvegarde.java`)
- Programme panel → Cinema catalogue: manages programme (evidence: `VideoClub/src/videoclub/PanneauProgramme.java`)
- Programme panel → Film details: creates (evidence: `VideoClub/src/videoclub/PanneauProgramme.java`)
- Programme panel → Room layout: creates (evidence: `VideoClub/src/videoclub/PanneauProgramme.java`)
- Programme panel → Screening: creates (evidence: `VideoClub/src/videoclub/PanneauProgramme.java`)
- Reservation panel → Cinema catalogue: reserves seats (evidence: `VideoClub/src/videoclub/PanneauReservations.java`)
- Reservation panel → Screening: reads occupancy (evidence: `VideoClub/src/videoclub/PanneauReservations.java`)
- Screening → Room layout: checks layout (evidence: `VideoClub/src/videoclub/Seance.java`)
- Room layout → Seat: provides seats (evidence: `VideoClub/src/videoclub/Salle.java`)
- Screening → Reservation record: creates and tracks (evidence: `VideoClub/src/videoclub/Seance.java`)
- Reservation record → Seat: records seats (evidence: `VideoClub/src/videoclub/Reservation.java`)
- Screening → Occupied-seat error: throws on conflict (evidence: `VideoClub/src/videoclub/Seance.java`)
- Cinema catalogue → Screening: delegates booking (evidence: `VideoClub/src/videoclub/Cinema.java`)
