#ifndef IMS_AUDIT_LOGGER_HPP
#define IMS_AUDIT_LOGGER_HPP

#include "ims_types.hpp"
#include <memory>
#include <vector>

namespace ims {

/// @brief 审计日志管理类。
///
/// 负责系统登录日志、操作日志、异常日志的记录与溯源查询。
class AuditLogger {
public:
    AuditLogger();
    ~AuditLogger();

    // ==================== 登录日志记录 (SRS-IMS_F-023) ====================

    /**
     * @brief 记录用户登录日志。
     *
     * @requirement(name="登录日志记录", id="SRS-IMS_F-023")
     * 记录用户登录成功/失败的时间、IP 等信息。
     */
    void logLogin(int64_t user_id,
                  const std::string& username,
                  bool success,
                  const std::string& ip_address);

    // ==================== 操作日志记录 (SRS-IMS_F-024) ====================

    /**
     * @brief 记录关键操作日志。
     *
     * @requirement(name="操作日志记录", id="SRS-IMS_F-024")
     * 记录用户对业务数据的关键操作（新增、修改、删除、审核等）。
     */
    void logOperation(int64_t user_id,
                      const std::string& username,
                      const std::string& action,
                      const std::string& detail);

    // ==================== 异常日志记录 (SRS-IMS_F-025) ====================

    /**
     * @brief 记录系统异常日志。
     *
     * @requirement(name="异常日志记录", id="SRS-IMS_F-025")
     * 记录系统运行时发生的异常或错误信息。
     */
    void logException(const std::string& action,
                      const std::string& detail);

    // ==================== 日志溯源查询 (SRS-IMS_F-026) ====================

    /**
     * @brief 多条件查询日志，支持溯源。
     *
     * @requirement(name="日志溯源查询", id="SRS-IMS_F-026")
     * 按日志类型、用户、时间范围、操作内容等多条件组合检索日志。
     */
    std::vector<LogEntry> queryLogs(
        LogType log_type,
        int64_t user_id,
        const std::string& keyword,
        const std::chrono::system_clock::time_point& start_time,
        const std::chrono::system_clock::time_point& end_time);

private:
    struct Impl;
    std::unique_ptr<Impl> pImpl_;
};

}  // namespace ims

#endif  // IMS_AUDIT_LOGGER_HPP