Clarification

server/logger.js

@@ -16,51 +16,61 @@
   along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
-const { createLogger, format, transports } = require("winston");
-const DailyRotateFile = require("winston-daily-rotate-file");
-const fs = require("fs");
-const path = require("path");
+const { createLogger, format, transports } = require("winston"); 
+// on importe Winston (logger populaire pour Node.js)
 
+const DailyRotateFile = require("winston-daily-rotate-file"); 
+// plugin pour Winston qui permet la rotation automatique des fichiers de logs
+
+const fs = require("fs");       // pour vérifier/créer le dossier de logs
+const path = require("path");   // pour gérer proprement les chemins
+
+// on définit le dossier de logs
 const logDir = path.join(__dirname, "../logs");
+// on le crée si inexistant
 if (!fs.existsSync(logDir)) fs.mkdirSync(logDir);
 
+// fonction pour générer une ligne de début de session (date ISO)
 function getSessionStartLine() {
   const now = new Date().toISOString();
   return `--- Démarrage de la session : ${now} ---`;
 }
 
+// fonction pour générer une ligne de fin de session (date ISO)
 function getSessionEndLine() {
   const now = new Date().toISOString();
   return `--- Fin de la session : ${now} ---`;
 }
 
+// configuration principale de Winston
 const logger = createLogger({
-  level: "info",
+  level: "info", // niveau de log minimum (info, warn, error, etc.)
   format: format.combine(
-    format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }),
+    format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), // timestamp lisible
     format.printf(({ timestamp, level, message }) =>
-      `${timestamp} | ${level.toUpperCase()} |  ${message}`
+      `${timestamp} | ${level.toUpperCase()} |  ${message}` // format de ligne de log
     )
   ),
   transports: [
     new DailyRotateFile({
-      dirname: logDir,
-      filename: "combined-%DATE%.log",
-      datePattern: "YYYY-MM-DD",
-      zippedArchive: false,  // tu peux mettre true si tu veux compresser
-      maxFiles: "14d",       // conserve les logs des 14 derniers jours
+      dirname: logDir,                     // dossier de logs
+      filename: "combined-%DATE%.log",     // nom de fichier journalier
+      datePattern: "YYYY-MM-DD",           // pattern de rotation
+      zippedArchive: false,                // true = compression des archives
+      maxFiles: "14d",                     // garde 14 jours d’historique
       format: format.combine(
         format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }),
         format.printf(({ timestamp, level, message }) =>
           `${timestamp} | ${level.toUpperCase()} |  ${message}`
         )
       ),
-      options: { flags: "a" },
+      options: { flags: "a" },             // mode append
     }),
     new transports.Console({
+      // sortie console colorisée (dev en local)
       format: format.combine(
         format.colorize(),
-        format.timestamp({ format: "HH:mm:ss" }),
+        format.timestamp({ format: "HH:mm:ss" }), // horodatage plus court
         format.printf(({ timestamp, level, message }) =>
           `${timestamp} | ${level} |  ${message}`
         )
@@ -69,14 +79,17 @@ const logger = createLogger({
   ],
 });
 
+// fonction d'utilitaire pour marquer le début de la session
 function logSessionStart() {
   logger.info(getSessionStartLine());
 }
 
+// idem pour la fin de la session
 function logSessionEnd() {
   logger.info(getSessionEndLine());
 }
 
+// exporte le logger et les helpers pour les autres modules
 module.exports = {
   logger,
   logSessionStart,