// kiosk-shell 状态机
//
// 对应《VDI 云桌面软件开发方案》3.2 节：
//   状态机：BOOT -> CONFIG（无配置）-> CONNECTING -> SESSION（嵌入 freerdp 窗口）
//            -> RECONNECT -> ERROR
//
// 状态转换规则：
//   BOOT      进程启动，读取本地配置
//   CONFIG    无可用配置或用户停留在登录页，等待输入
//   CONNECTING 正在建立 RDP 连接
//   SESSION   远程会话进行中
//   RECONNECT 会话意外断开，等待重连
//   ERROR     不可恢复错误，提示后回到 CONFIG

#ifndef KIOSK_SHELL_STATE_MACHINE_H
#define KIOSK_SHELL_STATE_MACHINE_H

#include <QString>
#include <functional>
#include <string>

namespace vdi {

enum class State {
    kBoot,          // 启动中
    kConfig,        // 首配 / 登录页
    kAuthenticating, // 正在认证
    kDesktopList,   // 桌面列表（登录成功后）
    kConnecting,    // 连接中
    kSession,       // 会话中
    kReconnect,     // 断线等待重连
    kError,         // 错误
};

const char* stateToString(State s);

class StateMachine {
public:
    // 状态说明使用 QString，便于直接显示在状态条上
    using StateListener = std::function<void(State from, State to, const QString& detail)>;

    explicit StateMachine(StateListener listener = nullptr);

    State current() const { return current_; }
    bool isIn(State s) const { return current_ == s; }

    // 尝试切换到目标状态；非法转换会被拒绝并返回 false
    bool transitionTo(State next, const QString& detail = QString());

    // 当前状态下允许执行的动作
    bool canConnect() const;
    bool canDisconnect() const;
    bool canRetry() const;

private:
    static bool isLegalTransition(State from, State to);

    State current_ = State::kBoot;
    StateListener listener_;
};

}  // namespace vdi

#endif  // KIOSK_SHELL_STATE_MACHINE_H