# graphicshack/travail_de_session_inf1007 architecture

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

## Overview

This is a browser-based client and administrator portal for managing users and network decoders. Users sign in and view a decoder summary; administrators manage clients and their decoder assignments, then inspect decoder status or issue reset, reinitialization, shutdown, and channel changes. The graph separates page controllers, API services, decoder/user domain models, and the server/data layer. Source excerpts show frontend API calls and decoder-model behavior, but the server implementation and HTML wiring were not sampled, so those connections are limited or marked unverified.

Main entry points: [`js/controllers/decoderController.js`](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/controllers/decoderController.js) (Decoder controls), [`pages`](https://github.com/graphicshack/travail_de_session_inf1007/tree/main/pages) (Portal pages), [`js/services/decoderService.js`](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/services/decoderService.js) (Decoder API service), [`js/controllers/clientController.js`](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/controllers/clientController.js) (Client management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Portal workflows"]
  node_pages["Portal pages"]
  node_auth["Authentication<br/>[authController.js]"]
  node_client["Client management"]
  node_dashboard["Dashboard"]
  node_decoder["Decoder controls"]
end

subgraph group_services["API services"]
  node_user_service["User API service<br/>[userService.js]"]
  node_decoder_service["Decoder API service<br/>[decoderService.js]"]
  node_config["API configuration<br/>[config.js]"]
end

subgraph group_domain["Domain models"]
  node_user_model["User model<br/>[Utilisateur.js]"]
  node_admin_model["Administrator model<br/>[Administrateur.js]"]
  node_decoder_model["Decoder model<br/>[Decodeur.js]"]
  node_state_model["Decoder states<br/>[EtatDecodeur.js]"]
  node_operation_model["Decoder operations<br/>[Operation.js]"]
  node_operation_status["Operation statuses<br/>[StatutOperation.js]"]
  node_content_model["Decoder content<br/>[Contenu.js]"]
end

subgraph group_backend["Server and data"]
  node_server["Express server<br/>[server.js]"]
  node_user_data[("User records<br/>[users.json]")]
end

node_actor(("Portal user"))
node_api{{"Local API"}}
node_decoder_api{{"Decoder endpoint"}}

node_actor -.->|"uses"| node_pages
node_pages -.->|"hosts"| node_auth
node_pages -.->|"hosts"| node_client
node_pages -.->|"hosts"| node_dashboard
node_pages -.->|"hosts"| node_decoder
node_auth -->|"authenticates"| node_user_service
node_client -->|"manages clients"| node_user_service
node_client -->|"displays decoders"| node_decoder
node_dashboard -->|"requests status"| node_decoder_service
node_dashboard -->|"reads user"| node_auth
node_decoder -->|"controls decoders"| node_decoder_service
node_decoder -->|"reads user"| node_auth
node_decoder -->|"unassigns decoder"| node_client
node_user_service -->|"reads API URL"| node_config
node_decoder_service -->|"reads endpoints"| node_config
node_user_service -->|"requests user routes"| node_api
node_decoder_service -->|"requests channel routes"| node_api
node_decoder_service -->|"sends actions"| node_decoder_api
node_decoder -->|"updates state"| node_decoder_model
node_decoder_model -->|"uses states"| node_state_model
node_decoder_model -->|"records operations"| node_operation_model
node_operation_model -->|"uses statuses"| node_operation_status
node_admin_model -->|"extends user"| node_user_model
node_api -.->|"served by"| node_server
node_server -.->|"may persist users"| node_user_data

click node_pages "https://github.com/graphicshack/travail_de_session_inf1007/tree/main/pages"
click node_auth "https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/controllers/authController.js"
click node_client "https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/controllers/clientController.js"
click node_dashboard "https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/controllers/dashboardController.js"
click node_decoder "https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/controllers/decoderController.js"
click node_user_service "https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/services/userService.js"
click node_decoder_service "https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/services/decoderService.js"
click node_config "https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/utils/config.js"
click node_user_model "https://github.com/graphicshack/travail_de_session_inf1007/blob/main/model/Utilisateur.js"
click node_admin_model "https://github.com/graphicshack/travail_de_session_inf1007/blob/main/model/Administrateur.js"
click node_decoder_model "https://github.com/graphicshack/travail_de_session_inf1007/blob/main/model/Decodeur.js"
click node_state_model "https://github.com/graphicshack/travail_de_session_inf1007/blob/main/model/EtatDecodeur.js"
click node_operation_model "https://github.com/graphicshack/travail_de_session_inf1007/blob/main/model/Operation.js"
click node_operation_status "https://github.com/graphicshack/travail_de_session_inf1007/blob/main/model/StatutOperation.js"
click node_content_model "https://github.com/graphicshack/travail_de_session_inf1007/blob/main/model/Contenu.js"
click node_server "https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/server.js"
click node_user_data "https://github.com/graphicshack/travail_de_session_inf1007/blob/main/data/users.json"

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_pages,node_auth,node_client,node_dashboard,node_decoder,node_actor toneBlue
class node_user_service,node_decoder_service,node_config toneAmber
class node_user_model,node_admin_model,node_decoder_model,node_state_model,node_operation_model,node_operation_status,node_content_model,node_api toneMint
class node_server,node_user_data toneRose
class node_decoder_api toneIndigo
```

## Components

### Portal workflows

- [Portal pages](https://github.com/graphicshack/travail_de_session_inf1007/tree/main/pages): `pages`
- [Authentication](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/controllers/authController.js): `js/controllers/authController.js`
- [Client management](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/controllers/clientController.js): `js/controllers/clientController.js`
- [Dashboard](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/controllers/dashboardController.js): `js/controllers/dashboardController.js`
- [Decoder controls](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/controllers/decoderController.js): `js/controllers/decoderController.js`

### API services

- [User API service](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/services/userService.js): `js/services/userService.js`
- [Decoder API service](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/services/decoderService.js): `js/services/decoderService.js`
- [API configuration](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/utils/config.js): `js/utils/config.js`

### Domain models

- [User model](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/model/Utilisateur.js): `model/Utilisateur.js`
- [Administrator model](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/model/Administrateur.js): `model/Administrateur.js`
- [Decoder model](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/model/Decodeur.js): `model/Decodeur.js`
- [Decoder states](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/model/EtatDecodeur.js): `model/EtatDecodeur.js`
- [Decoder operations](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/model/Operation.js): `model/Operation.js`
- [Operation statuses](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/model/StatutOperation.js): `model/StatutOperation.js`
- [Decoder content](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/model/Contenu.js): `model/Contenu.js`

### Server and data

- [Express server](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/js/server.js): `js/server.js`
- [User records](https://github.com/graphicshack/travail_de_session_inf1007/blob/main/data/users.json): `data/users.json`

### Other components

- **Portal user**
- **Local API**
- **Decoder endpoint**

## Connections

- Portal user → Portal pages: uses
- Portal pages → Authentication: hosts
- Portal pages → Client management: hosts
- Portal pages → Dashboard: hosts
- Portal pages → Decoder controls: hosts
- Authentication → User API service: authenticates (evidence: `js/controllers/authController.js`)
- Client management → User API service: manages clients (evidence: `js/controllers/clientController.js`)
- Client management → Decoder controls: displays decoders (evidence: `js/controllers/clientController.js`)
- Dashboard → Decoder API service: requests status (evidence: `js/controllers/dashboardController.js`)
- Dashboard → Authentication: reads user (evidence: `js/controllers/dashboardController.js`)
- Decoder controls → Decoder API service: controls decoders (evidence: `js/controllers/decoderController.js`)
- Decoder controls → Authentication: reads user (evidence: `js/controllers/decoderController.js`)
- Decoder controls → Client management: unassigns decoder (evidence: `js/controllers/decoderController.js`)
- User API service → API configuration: reads API URL (evidence: `js/services/userService.js`)
- Decoder API service → API configuration: reads endpoints (evidence: `js/services/decoderService.js`)
- User API service → Local API: requests user routes (evidence: `js/services/userService.js`)
- Decoder API service → Local API: requests channel routes (evidence: `js/services/decoderService.js`)
- Decoder API service → Decoder endpoint: sends actions (evidence: `js/services/decoderService.js`)
- Decoder controls → Decoder model: updates state (evidence: `js/controllers/decoderController.js`)
- Decoder model → Decoder states: uses states (evidence: `model/Decodeur.js`)
- Decoder model → Decoder operations: records operations (evidence: `model/Decodeur.js`)
- Decoder operations → Operation statuses: uses statuses (evidence: `model/Operation.js`)
- Administrator model → User model: extends user (evidence: `model/Administrateur.js`)
- Local API → Express server: served by
- Express server → User records: may persist users
