validation_utils.h

См. документацию.

#pragma once
 
#ifdef TEST_BUILD
#include "../test/stubs/esp32_stubs.h"
#else
#include <Arduino.h>
#endif
#include <vector>
#include "modbus_sensor.h"  // Для SensorData
 
// ============================================================================
// СТРУКТУРЫ РЕЗУЛЬТАТОВ ВАЛИДАЦИИ
// ============================================================================
 
struct ValidationResult
{
    bool isValid;
    String message;
};
 
struct ValidationError
{
    String field;
    String message;
};
 
struct ConfigValidationResult
{
    bool isValid;
    std::vector<ValidationError> errors;
};
 
struct SensorValidationResult
{
    bool isValid;
    std::vector<ValidationError> errors;
};
 
// ============================================================================
// СТРУКТУРЫ ДАННЫХ (forward declarations)
// ============================================================================
 
// Упрощенная структура конфигурации для валидации
struct ConfigData
{
    String ssid;
    String password;
    bool mqttEnabled;
    String mqttServer;
    int mqttPort;
    bool thingSpeakEnabled;
    String thingSpeakAPIKey;
    unsigned long sensorReadInterval;
    unsigned long mqttPublishInterval;
    unsigned long thingspeakInterval;
    unsigned long ntpUpdateInterval;
};
 
// SensorData определен в modbus_sensor.h
 
// ============================================================================
// ФУНКЦИИ ВАЛИДАЦИИ КОНФИГУРАЦИИ
// ============================================================================
 
ValidationResult validateSSID(const String& ssid);
 
ValidationResult validatePassword(const String& password);
 
ValidationResult validateMQTTServer(const String& server);
 
ValidationResult validateMQTTPort(int port);
 
ValidationResult validateThingSpeakAPIKey(const String& apiKey);
 
ValidationResult validateInterval(unsigned long interval, unsigned long min_val, unsigned long max_val,
                                  const char* name);
 
ValidationResult validateSensorReadInterval(unsigned long interval);
 
ValidationResult validateMQTTPublishInterval(unsigned long interval);
 
ValidationResult validateThingSpeakInterval(unsigned long interval);
 
ValidationResult validateNTPInterval(unsigned long interval);
 
// ============================================================================
// ФУНКЦИИ ВАЛИДАЦИИ ДАННЫХ ДАТЧИКА
// ============================================================================
 
ValidationResult validateRange(float value, float min_val, float max_val, const char* field_name);
 
ValidationResult validateTemperature(float temperature);
 
ValidationResult validateHumidity(float humidity);
 
ValidationResult validatePH(float ph);
 
ValidationResult validateEC(float ec);
 
ValidationResult validateNPK(float value, const char* nutrient);
 
// ============================================================================
// КОМПЛЕКСНАЯ ВАЛИДАЦИЯ
// ============================================================================
 
ConfigValidationResult validateFullConfig(const ConfigData& config, bool checkRequired = true);
 
SensorValidationResult validateFullSensorData(const SensorData& data);
 
// ============================================================================
// УТИЛИТЫ ВАЛИДАЦИИ
// ============================================================================
 
bool isValidIPAddress(const String& ip);
 
bool isValidHostname(const String& hostname);
 
String formatValidationErrors(const ConfigValidationResult& result);
 
String formatSensorValidationErrors(const SensorValidationResult& result);
 
// ============================================================================
// ЛОГИРОВАНИЕ ВАЛИДАЦИИ
// ============================================================================
 
void logValidationResult(const ConfigValidationResult& result, const char* context);
 
void logSensorValidationResult(const SensorValidationResult& result, const char* context);