// 文件名: src/web/web_server.h
#ifndef WEB_SERVER_H
#define WEB_SERVER_H

#include "crow.h" // 引入 Crow 库的头文件
#include "systemMonitor/system_monitor.h"
#include <thread>

/**
 * @brief Web服务器模块
 * * 负责启动一个后台HTTP服务器，为前端提供RESTful API接口。
 * 它在自己的线程中运行，以避免阻塞主程序的io_context事件循环。
 */
class WebServer {
public:
    /**
     * @brief 构造函数
     * @param monitor SystemMonitor的引用，用于获取系统状态数据
     * @param port Web服务器监听的端口号，默认为8080
     */
    WebServer(SystemMonitor::SystemMonitor& monitor, uint16_t port = 8080);

    /**
     * @brief 析构函数
     * * 确保在程序退出时，Web服务线程能够被安全地停止和清理。
     */
    ~WebServer();

    // 禁止拷贝和赋值，因为该类管理着一个线程资源
    WebServer(const WebServer&) = delete;
    WebServer& operator=(const WebServer&) = delete;

    /**
     * @brief 在后台线程中启动Web服务
     */
    void start();

    /**
     * @brief 停止Web服务并等待线程退出
     */
    void stop();

private:
    /**
     * @brief 设置所有的API路由（URL路径）
     */
    void setup_routes();

    crow::SimpleApp m_app; // Crow 应用实例
    SystemMonitor::SystemMonitor& m_monitor;
    uint16_t m_port;
    
    std::thread m_thread; // 运行Web服务的后台线程
};

#endif // WEB_SERVER_H