https://github.com/mzilinassim/gestion-bibliotheque
TP - microservices - node js, express and mongodb "Gestion-bibliotheque" \clinets \books \auth \emprunts \notifications \Paiement
https://github.com/mzilinassim/gestion-bibliotheque
bycrypt express jsonwebtoken microservices mongodb nodejs
Last synced: 8 months ago
JSON representation
TP - microservices - node js, express and mongodb "Gestion-bibliotheque" \clinets \books \auth \emprunts \notifications \Paiement
- Host: GitHub
- URL: https://github.com/mzilinassim/gestion-bibliotheque
- Owner: mziliNassim
- Created: 2025-01-08T02:29:17.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-01-15T22:18:29.000Z (9 months ago)
- Last Synced: 2025-01-16T00:07:29.369Z (9 months ago)
- Topics: bycrypt, express, jsonwebtoken, microservices, mongodb, nodejs
- Language: JavaScript
- Homepage: https://mzilinassim.github.io/gestion-bibliotheque/
- Size: 38.1 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Gestion des Emprunts d'une Librairie
## Navigation
- [Envirement Variables](#envirement-variables)
- [Authentification](#authentification)
- [1 - Register a User](#1---register-a-user)
- [2 - Login User](#2---login-user)
- [3 - Logout User](#3---logout-user)
- [Services](#services)
- [1 - Service de Gestion des Livres](#1---service-de-gestion-des-livres)
- [2 - Service de Gestion des Emprunts](#2---service-de-gestion-des-emprunts)
- [3 - Service de Gestion des Clients](#3---service-de-gestion-des-clients)
## Envirement Variables
```.env
PORT = 5000
# DB Configuration
MONGODB_URI = mongodb://localhost:27017/ # ou votre URI MongoDB
DB_NAME = gestion-bibliotheque
# JWT Configuration
JWT_SECRET = "your_jwt_secret_key"
JWT_EXPIRES_IN = "1d"
```
## Authentification
> Manages user authentication in the application.
> Includes routes for user registration, login, and logout.
### 1 - Register a User
- **description:** Registers a new user in the system and provides a JWT token for future requests.
- **Method:** _`POST`_
- **Root:** .../auth/register
- **Request Body:**
```json
{
"username": "exampleUsername",
"email": "example@example.com",
"password": "securePassword",
"confirmPassword": "securePassword"
}
```
- **Response:**
- **201 Created:**
```json
{
"message": "User registered successfully.",
"data": "USER_INFOS",
"token": "JWT_TOKEN"
}
```
- **400 Bad Request:**
```json
{ "message": "MESSAGE_WHILE_PROCESS", "data": null }
```
- **500 Internal Server Error:**
```json
{ "message": "Internal server error", "data": null }
```
### 2 - Login User
- **Description:** Authenticates a user and provides a JWT token for future requests.
- **Method:** _`POST`_
- **Root:** .../auth/login
- **Request Body:**
```json
{
"email": "example@example.com",
"password": "securePassword"
}
```
- **Response:**
- **201 Created:**
```json
{
"message": "Login successful.",
"data": "USER_INFOS",
"token": "JWT_TOKEN"
}
```
- **400 Bad Request:**
```json
{ "message": "MESSAGE_WHILE_PROCESS", "data": null }
```
- **500 Internal Server Error:**
```json
{ "message": "Internal server error", "data": null }
```
### 3 - Logout User
- **Description:** Ends the user's session by invalidating the authentication token.
- **Method:** _`POST`_
- **Root:** .../auth/logout
- **Request Body:** _(No body required)_
- **Headers Required:**
- **Authorization:** `Bearer `
```js
// JS Example
headers: {
'Authorization': `Bearer ${token}`,
'Content-Type': 'application/json'
}
```
- **Response:**
- **200 OK:**
```json
{ "message": "Logout successful.", "data": null }
```
- **401 Unauthorized:**
```json
{ "error": "Unauthorized. Token missing or invalid.", "data": null }
```
- **500 Internal Server Error:**
```json
{ "message": "Internal server error", "data": null }
```
## Services
### 1 - **Service de Gestion des Livres**
- **Responsabilité** :
- Gérer les informations sur les livres disponibles dans la librairie.
- **Fonctionnalités** :
- Afficher, Ajouter, modifier et supprimer des livres.
- Consulter la disponibilité des livres.
- Mettre à jour l’état d’un livre (disponible, emprunté, réservé).
- **Canal de communication** :
- API REST pour les interactions avec d’autres services.
- **Base de données** :
- Une base de données pour les informations sur les livres (isbn, titre, auteur, categorie, annee_publication, editeur, langue, description, tags, disponible).
### 2 - **Service de Gestion des Emprunts**
- **Responsabilité** :
- Gérer les emprunts effectués par les clients.
- **Fonctionnalités** :
- Créer, mettre à jour la disponibilité et la retourne des emprunts.
- **Canal de communication** :
- API REST.
- Messages asynchrones pour notifier d’autres services (service de notification).
- **Base de données** :
- Une base de données pour les enregistrements des emprunts (clientId, livreId, startDate, returnDate, status).
### 3 - **Service de Gestion des Clients**
- **Responsabilité** :
- Gérer les informations et les profils des clients.
- **Fonctionnalités** :
- Ajouter, modifier et supprimer des clients.
- Suivre les emprunts en cours et les historiques des clients.
- **Canal de communication** :
- API REST pour fournir les informations sur les clients aux autres services.
- **Base de données** :
- Une base de données pour les profils des clients (username, email, password (Hash Password), historique des emprunts).
### 4 -