/*!
 *
 * Copyright (c) 2020-2022 Diality Inc. - All Rights Reserved.
 * \copyright
 * THIS CODE MAY NOT BE COPIED OR REPRODUCED IN ANY FORM, IN PART OR IN
 * WHOLE, WITHOUT THE EXPLICIT PERMISSION OF THE COPYRIGHT OWNER.
 *
 * \file    Logger.h
 * \author  (last)      Behrouz NematiPour
 * \date    (last)      28-Sep-2022
 * \author  (original)  Behrouz NematiPour
 * \date    (original)  26-Aug-2020
 *
 */
#pragma once

// Qt
#include <QObject>
#include <QDir>
#include <QFutureWatcher>

// Project
#include "main.h" // Doxygen : do not remove
#include "StorageGlobals.h"
#include "GuiGlobals.h"

// Define
#define _Logger             Storage::Logger::I()

#define LOG_EXPORTLOG(vExportName)          _Logger.concurrentExportLogs(vExportName)
#define LOG_EXPORTERR(vExportName)          _Logger.concurrentExportErrs(vExportName)
#define LOG_EXPORTTRT(vExportName)          _Logger.concurrentExportTrts(vExportName)

#define ADD_EVENT_HEADER    emit Storage::Logger::I().didLog(_headerE, Storage::Logger::LogType::eLogEvent, false)
#define LOG_EVENT(vCONTENT) emit Storage::Logger::I().didLog(vCONTENT, Storage::Logger::LogType::eLogEvent, true )
#define LOG_DATUM(vCONTENT) emit Storage::Logger::I().didLog(vCONTENT, Storage::Logger::LogType::eLogDatum, true )
#define LOG_DEBUG(vCONTENT) emit Storage::Logger::I().didLog(vCONTENT, Storage::Logger::LogType::eLogDebug, true )

#define LOG_EVENT_UI(vCONTENT) emit Storage::Logger::I().didLog("UI," + vCONTENT, Storage::Logger::LogType::eLogEvent, true )
#define LOG_DATUM_UI(vCONTENT) emit Storage::Logger::I().didLog("UI," + vCONTENT, Storage::Logger::LogType::eLogDatum, true )

#define MIXED_EVENT_DATUM

// forward declarations
class tst_logging;

namespace Storage {

/*!
 * \brief   The Logger class
 * \details Main logger class that has all the required implementation for logging.
 *          The provided interface is the LOG_DATUM, LOG_EVENT, LOG_DEBUG, LOG_EXPORT defines
 *          and no other methods.
 *
 *          This object is logging all the registered Denali Messages transactions over the CANBus in CSV format text file.
 *          Logger class currently has 3 types  which are Event, Error, Datum.
 *          The Event and Data messages are logged in the csv file with "log" extension
 *          and the UI Application specific errors are logged in a csv file with the "err" extension.
 *          Logs file names format start with current system date by "<yyyy_MM_dd>" format and "_denali.<ext>".
 *          The content of the file is depending on each log type and has "<HH:mm:ss>,<type>,<source>,<description>,<information/Data>".
 *          Currently, the file name and content formatting can be modified by changing the formatting values in Logger class.
 *
 *          This class has its own thread for logging.
 *          Also for exporting the log files it uses asynchronous thread calling by QtConcurrent.
 *          It communicated with other classes only with Signal/Slots for thread safety and will notify other classes when the export is done by signals.
 *
 * \note
 *          PLEASE BE CAREFUL THIS CLASS IS USING QtConcurrent::run FOR THE EXPORT LOG FILES.
 *          AND ONLY PRIVATE VOID LOG (,) IS CALLING IN POOLED THREAD
 *          PLEASE BE VERY CAREFUL.
 *          ALL THE OTHER CLASSES TO USE THIS CLASS SHOULD ONLY USE LOG_DATUM, LOG_EVENT, LOG_DEBUG
 *          TO DO THE LOGGING
 */
class Logger : public QObject
{
    Q_OBJECT

    // Singleton
    SINGLETON(Logger)

    // friends
    friend class ::tst_logging;

public :
    enum LogType {
        eLogNone = -1,

        eLogDebug, ///< Application Error      : CANBus messages does not have error it's Event/Data only

        eLogEvent, ///< Massages on the CANBus : Error is an event type
        eLogDatum, ///< Massages on the CANBus : Broadcast data type

        eLogTrtmt, ///< Treatment Log Files

        eLogType_Count,
    };
    Q_ENUM(LogType)

private:

    bool _logStorageReady = true;

    const   char *_headerE = "TimeStamp,Type,SubSys,Name,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40";
    QDir    _dir;
    QString _logFileNamePrefix;
    QHash<LogType, QString> _logPathNames;
    const QHash<LogType, const char *> _logBasePathNames {
        { LogType::eLogEvent,  Storage::Log_Folder_Event      },
        { LogType::eLogDatum,  Storage::Log_Folder_Data       },
        { LogType::eLogDebug,  Storage::Log_Folder_Service    },
        { LogType::eLogTrtmt,  Storage::Log_Folder_Treatment  },
    };

    const QHash<LogType, const char *> _logPrefix { // Will be used for the logging in the file
        { LogType::eLogEvent,  "E" },
        { LogType::eLogDatum,  "D" },
        { LogType::eLogDebug,  ""  }, // it has its own file and all the content is Error
    };

    const QHash<LogType, const char *> _logNames { // Will be used for the logging in the file
        { LogType::eLogEvent,  "Log"        },
        { LogType::eLogDatum,  "Service"    },
        { LogType::eLogDebug,  "Treatment"  }, // it has its own file and all the content is Error
    };

    const QHash<LogType, const char *> _logFileNameExt {
        { LogType::eLogEvent,  ".log" },
#ifdef MIXED_EVENT_DATUM
        { LogType::eLogDatum,  ".log" },
#else
        { LogType::eLogDatum,  ".dat" },
#endif
        { LogType::eLogDebug,  ".err" },
        { LogType::eLogTrtmt,  ".log" },
    };

    // !!!!!!!!!! IMPORTANT !!!!!!!!!!
    // be careful with these percentages
    // please refer to the Storage namespace.
    const QHash<LogType, quint16> _logTypeMaxUsageLimit {
#ifdef MIXED_EVENT_DATUM
        { LogType::eLogEvent, Storage::Log_Max_Allowable_AppED_Space_Percent },
        { LogType::eLogDatum, Storage::Log_Max_Allowable_AppED_Space_Percent },
#else
        { LogType::eLogEvent, Storage::Log_Max_Allowable_Event_Space_Percent },
        { LogType::eLogDatum, Storage::Log_Max_Allowable_Datum_Space_Percent },
#endif
        { LogType::eLogDebug, Storage::Log_Max_Allowable_Debug_Space_Percent },
        // Not Sure yet so commented out in the remove.
        { LogType::eLogTrtmt, Storage::Log_Max_Allowable_Trtmt_Space_Percent },
    };

    const char *_dateFormat = "yyyy_MM_dd"  ; // date used in the file name
    const char *_timeFormat = "HH:mm:ss.zzz"; // timestamp in the file

    const char *_dateSeparator    = "_"; // used in filename
    const char *_separator        = ",";

    bool        _enableConsoleOut = false;

    QString     _logFileName      = "";
    QMutex      _logRemoveRunning;

    LogType              _exportLogsType    = eLogNone;
    QFutureWatcher<bool> _exportLogsWatcher;
    QFutureWatcher<int > _removeLogsWatcher;

    QThread       *_thread       = nullptr;
    bool           _init         = false;

public:
    void enableConsoleOut(bool vEnabled);
    void postInit();

signals:
    void didLogPathSet(Logger::LogType vLogType, const QString &vLogPath);

public slots:
    bool init();
    bool init(QThread &vThread);
    void quit();

private:
    void initConnections();

    void initThread(QThread &vThread);
    void quitThread();

    bool checkThread();

private:
    // ----- setting up
    void checkLogPath   ();
    void setLogBasePath (bool vUseApplicationDirPath = false);
    bool setLogPath     ();
    bool setLogPath     (LogType vLogType);
public:
    const QString &logPath(Logger::LogType vLogType);

    // ----- Export structure
private :
    bool           exportLogs(const Gui::GuiStringIndexMap &vExportList);
    bool           exportErrs(const Gui::GuiStringIndexMap &vExportList);
    bool           exportTrts(const Gui::GuiStringIndexMap &vExportList);
public slots: // this slot is thread safe and can be called from outside by LOG_EXPORT.
    bool concurrentExportIsOk   ();
    bool concurrentExportLogs   (const Gui::GuiStringIndexMap &vExportList);
    bool concurrentExportErrs   (const Gui::GuiStringIndexMap &vExportList);
    bool concurrentExportTrts   (const Gui::GuiStringIndexMap &vExportList);
    void         onExportLogs   ();
signals:
    void        didExportLogs();

    // ----- Remove Old Logs structure
private:
    int            removeLogs();
private slots: // this slot is thread safe and can be called from outside but preferred not to.
    bool concurrentRemoveLogs();
    void         onRemoveLogs();
signals:
    /*!
     * \brief   didRemoveLogs
     * \details This signal will be emitted mainly for DeviceController to not to emit the signal that Logger is connected to
     *          , while the logging cleanup is in progress, otherwise if the log cleanup takes more that 1sec (current interval)
     *          in the DeviceController then the cleanup will be called again for no good reason.
     * \param   vInProgress - true if the log cleanup is in progress, false otherwise.
     */
    void didRemoveLogs(bool vInProgress);

    // ----- Available space is low
private slots:
    void onSDCardStateChange(bool vReady, bool vReadonly);
    void onSDCardSpaceChange(bool vReady, qint64 vTotal, qint64 vAvailable, quint8 vPercent);

    // ----- logging structure
private slots:
    void onLog  (const QString &vContent, LogType vLogType, bool vTimestamp);
private:
    void log    (const QString &vContent, LogType vLogType, bool vTimestamp);

signals:
    /*!
     * \brief   didLog
     * \details Notifies the logger on a request for log
     * \param   vContent - content as type of string to be logged
     * \param   vLogType - the type of logging of type Storage::Logger::LogType
     */
    void didLog          (const QString &vContent, LogType vLogType, bool vTimestamp);
};
}