ExerciseEngine.h

Go to the documentation of this file.

// Copyright 2015 - 2026, GIBIS-UNIFESP and the wiRedPanda contributors
// SPDX-License-Identifier: GPL-3.0-or-later
 
#pragma once
 
#include <QObject>
#include <QPointer>
#include <QVector>
 
#include "App/Core/StepEngineCore.h"
#include "App/Exercise/ExerciseStep.h"
 
class Scene;
 
class ExerciseEngine : public QObject
{
    Q_OBJECT
 
public:
    explicit ExerciseEngine(QObject *parent = nullptr);

    bool loadFromResource(const QString &resourcePath);
 
    QString exerciseId()    const { return m_core.id(); }
    QString exerciseTitle() const { return m_core.title(); }

    void setScene(Scene *scene);
 
    int  currentStep() const { return m_core.currentStep(); }
    int  totalSteps()  const { return m_core.totalSteps(); }
    bool isActive()    const { return m_core.isActive(); }

    const ExerciseStep &currentStepData() const;
 
    void start();
    void stop();
    void goToPreviousStep();

    void advanceStep();

    void retranslate();
 
signals:
    void stepChanged(int step, int total, const ExerciseStep &data);
    void stepCompleted(int step);
    void exerciseCompleted();
    void exerciseStopped();
    void retranslated();
 
private slots:
    void onCircuitChanged();
 
private:
    bool validateCurrentStep() const;
 
    bool validateElements(const QVector<ExerciseElementRequirement> &reqs) const;
    bool validateConnections(const QVector<ExerciseConnectionRequirement> &reqs) const;
 
    void emitCurrentStep();
    void markCompleted();

    void performAdvance();
 
    StepEngineCore<ExerciseStep> m_core;
    QPointer<Scene> m_scene;
};