etm-powersync-energy-plugin.../energyplugin/nymeaenergyjsonhandler.h
Patrick Schurig 444b13dbf8 feat(ratios): NymeaEnergy.GetEnergyRatios + EnergyRatiosChanged (voie c)
Expose autoconsommation/autonomie comme source canonique de l'energymanager,
pour remplacer le seam interim app-side (EnergyRatiosInterim.compute).

Voie (c) : méthode + notification sur le handler NymeaEnergy de NOTRE plugin
(déjà forké/buildé), calculées depuis EnergyManager::totalX() — interface
abstraite stable. PAS de champs sur Energy.PowerBalance → aucun fork du coeur
nymea (nymea-experience-plugin-energy) à rebaser perpétuellement.

- EnergyRatiosCalculator (GPL pur mesure) : Δ de cumuls, baseline minuit local,
  reseed (1er appel / nouveau jour / non-monotone Δ<0), den<=0 -> n/a, clamp
  [0,100]. Porté 1:1 du seam interim app.
- NymeaEnergy.GetEnergyRatios -> {o:selfConsumptionRate, o:autonomyRate} Double,
  champ OMIS si n/a (jamais null).
- NymeaEnergy.EnergyRatiosChanged : meme forme, branchee sur powerBalanceChanged(),
  emise uniquement quand une valeur (ou sa disponibilite) change.
- testEnergyRatiosAlignment : vecteurs joues 1:1 contre l'interim (seed, normal,
  clamp-bas, den<=0->n/a, non-monotone, nouveau jour local).
- docs/INTERFACE_energyratios.md : contrat pour l'agent app (RPC a consommer).

Build prod 0/0. Suite simulation 25/0 (testLoadConfigRpc traverse le handler
modifie -> pas de regression).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-01 07:56:35 +02:00

109 lines
4.4 KiB
C++

// SPDX-License-Identifier: GPL-3.0-or-later
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
*
* Copyright (C) 2013 - 2024, nymea GmbH
* Copyright (C) 2024 - 2025, chargebyte austria GmbH
*
* This file is part of nymea-energy-plugin-nymea.
*
* nymea-energy-plugin-nymea.s free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* nymea-energy-plugin-nymea.s distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with nymea-energy-plugin-nymea. If not, see <https://www.gnu.org/licenses/>.
*
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
#ifndef NYMEAENERGYJSONHANDLER_H
#define NYMEAENERGYJSONHANDLER_H
#include <QObject>
#include <jsonrpc/jsonhandler.h>
#include "types/scoreentry.h"
#include "etm/ratios/energyratioscalculator.h"
class SmartChargingManager;
class SpotMarketManager;
class LoadConfigStore;
class EnergyManager;
class NymeaEnergyJsonHandler : public JsonHandler
{
Q_OBJECT
public:
explicit NymeaEnergyJsonHandler(SpotMarketManager *spotMarketManager, SmartChargingManager *smartChargingManager, LoadConfigStore *loadConfigStore = nullptr, EnergyManager *energyManager = nullptr, QObject *parent = nullptr);
QString name() const override;
Q_INVOKABLE JsonReply *GetPhasePowerLimit(const QVariantMap &params);
Q_INVOKABLE JsonReply *SetPhasePowerLimit(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetAcquisitionTolerance(const QVariantMap &params);
Q_INVOKABLE JsonReply *SetAcquisitionTolerance(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetBatteryLevelConsideration(const QVariantMap &params);
Q_INVOKABLE JsonReply *SetBatteryLevelConsideration(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetChargingInfos(const QVariantMap &params);
Q_INVOKABLE JsonReply *SetChargingInfo(const QVariantMap &params, const JsonContext &context);
Q_INVOKABLE JsonReply *GetLockOnUnplug(const QVariantMap &params);
Q_INVOKABLE JsonReply *SetLockOnUnplug(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetAvailableSpotMarketProviders(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetSpotMarketConfiguration(const QVariantMap &params);
Q_INVOKABLE JsonReply *SetSpotMarketConfiguration(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetSpotMarketScoreEntries(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetChargingSchedules(const QVariantMap &params);
Q_INVOKABLE JsonReply *GetLoadConfig(const QVariantMap &params);
Q_INVOKABLE JsonReply *SetLoadConfig(const QVariantMap &params);
// [Phase 2] Ratios canoniques (autoconsommation / autonomie), % [0,100].
Q_INVOKABLE JsonReply *GetEnergyRatios(const QVariantMap &params);
signals:
void PhasePowerLimitChanged(const QVariantMap &params);
void AcquisitionToleranceChanged(const QVariantMap &params);
void LockOnUnplugChanged(const QVariantMap &params);
void ChargingInfoAdded(const QVariantMap &params);
void ChargingInfoRemoved(const QVariantMap &params);
void ChargingInfoChanged(const QVariantMap &params);
void SpotMarketConfigurationChanged(const QVariantMap &params);
void SpotMarketScoreEntriesChanged(const QVariantMap &params);
void ChargingSchedulesChanged(const QVariantMap &params);
void BatteryLevelConsiderationChanged(const QVariantMap &params);
void LoadConfigChanged(const QVariantMap &params);
void EnergyRatiosChanged(const QVariantMap &params);
private slots:
void onPowerBalanceChanged();
private:
SpotMarketManager *m_spotMarketManager;
SmartChargingManager *m_smartChargingManager = nullptr;
LoadConfigStore *m_loadConfigStore = nullptr;
EnergyManager *m_energyManager = nullptr;
EnergyRatiosCalculator m_ratiosCalculator;
EnergyRatiosCalculator::Ratios m_lastRatios;
bool m_lastRatiosValid = false; // un calcul a-t-il déjà été émis ?
QVariantMap currentEnergyRatios();
void sendSpotMarketConfigurationChangedNotification();
};
#endif // NYMEAENERGYJSONHANDLER_H