MyEMS Documentation de conception de la base de données

À l'usage des développeurs : architecture, structure des tables et philosophie de MyEMS.

Sommaire

• Conception de l'Architecture de la Base de Données
• Description Détaillée des Bases de Données
• Relations de Flux de Données
• Normes de Conception de la Structure des Tables

---

Conception de l'Architecture de la Base de Données

Philosophie de Conception

1. Séparation des Données : Séparer les données dans différentes bases de données selon leur type et leur utilisation pour éviter qu'une base unique ne devienne trop volumineuse.
2. Séparation Lecture/Écriture : Les données historiques utilisent un stockage de séries temporelles pour supporter des requêtes efficaces.
3. Extensibilité Horizontale : Les grandes bases de données (historical_db, energy_db) peuvent être étendues indépendamment.
4. Normalisation Unifiée : Toutes les bases de données utilisent le même jeu de caractères et les mêmes règles de classement.

Configuration de la Base de Données

Toutes les bases de données utilisent la configuration uniforme suivante :

• Jeu de caractères : utf8mb4 (Prend en charge l'ensemble des caractères UTF-8, y compris les émojis)
• Collation : utf8mb4_unicode_ci (Règles de tri Unicode)
• Moteur de Stockage : InnoDB (Par défaut, prend en charge les transactions et les clés étrangères)

Conventions de Nommage

• Nommage des Bases de Données : myems_{fonctionnalité}_db (minuscules, séparés par des underscores)
• Nommage des Tables : tbl_{nom_entité} (minuscules, séparés par des underscores)
• Nommage des Champs : minuscules, séparés par des underscores, par exemple start_datetime_utc
• Nommage des Index : tbl_{nom_table}_index_{numéro}

---

Description Détaillée des Bases de Données

1. myems_system_db (Base de Données de Configuration du Système)

Usage : Stocke la configuration de base et les métadonnées du système. C'est la base de données centrale de configuration pour l'ensemble du système.

Caractéristiques :

• Contient le plus grand nombre de tables (environ 150+)
• Volume de données relativement faible, mais structure complexe
• Contient de nombreuses tables de relations

Catégories Principales de Tables :

1.1 Tables de Configuration de Base

Nom de la Table	Description	Champs Clés
tbl_energy_categories	Catégories d'énergie (électricité, eau, gaz, froid, chaleur, etc.)	id, name, unit_of_measure, kgce, kgco2e
tbl_energy_items	Postes de consommation d'énergie (éclairage, climatisation, puissance, etc.)	id, name, energy_category_id
tbl_cost_centers	Centres de coût	id, name, external_id
tbl_data_sources	Configuration des sources de données	id, name, gateway_id, protocol, connection
tbl_protocols	Configuration des protocoles	id, name, protocol_type

1.2 Tables de Gestion des Équipements

Nom de la Table	Description	Champs Clés
tbl_equipments	Informations sur les équipements	id, name, uuid, equipment_type_id, cost_center_id
tbl_combined_equipments	Équipements combinés (combinaison de plusieurs équipements)	id, name, is_input_counted, is_output_counted
tbl_meters	Informations sur les compteurs	id, name, uuid, energy_category_id, is_counted
tbl_offline_meters	Compteurs hors ligne (saisie manuelle)	id, name, energy_category_id
tbl_virtual_meters	Compteurs virtuels (calculés)	id, name, expression (format JSON)
tbl_points	Informations sur les points de données	id, name, data_source_id, object_type, object_id

1.3 Tables d'Organisation Spatiale

Nom de la Table	Description	Champs Clés
tbl_spaces	Informations spatiales (pièces, étages, etc.)	id, name, uuid, parent_space_id, area
tbl_stores	Informations sur les magasins	id, name, uuid, space_id
tbl_tenants	Informations sur les locataires	id, name, uuid, space_id
tbl_shopfloors	Informations sur les ateliers	id, name, uuid, space_id

1.4 Tables de Relations

Le système utilise de nombreuses tables d'association pour établir des relations plusieurs-à-plusieurs :

• tbl_equipments_meters: Association équipement-compteur
• tbl_equipments_offline_meters: Association équipement-compteur hors ligne
• tbl_equipments_virtual_meters: Association équipement-compteur virtuel
• tbl_spaces_equipments: Association espace-équipement
• tbl_spaces_meters: Association espace-compteur
• tbl_combined_equipments_equipments: Association équipement combiné-équipement
• etc...

1.5 Tables des Équipements d'Énergies Nouvelles

Nom de la Table	Description	Champs Clés
tbl_photovoltaic_power_stations	Centrales photovoltaïques	id, name, capacity, contact_id
tbl_energy_storage_containers	Conteneurs de stockage d'énergie	id, name, rated_capacity, rated_power
tbl_energy_storage_power_stations	Centrales de stockage d'énergie	id, name, rated_capacity
tbl_microgrids	Micro-réseaux	id, name, address
tbl_charging_stations	Stations de recharge	id, name, rated_capacity, rated_power

1.6 Tables de Contrôle et de Planification

Nom de la Table	Description	Champs Clés
tbl_commands	Commandes de contrôle	id, name, topic, payload (format JSON)
tbl_control_modes	Modes de contrôle	id, name, is_active
tbl_control_modes_times	Périodes de mode de contrôle	id, control_mode_id, start_time_of_day, end_time_of_day

1.7 Autres Tables de Configuration

• tbl_contacts: Informations de contact
• tbl_distribution_systems: Systèmes de distribution
• tbl_distribution_circuits: Circuits de distribution
• tbl_energy_flow_diagrams: Diagrammes de flux d'énergie
• tbl_tariffs: Configuration des tarifs
• tbl_working_calendars: Calendriers de travail
• tbl_web_messages: Messages Web

Considérations pour le Développement :

• Toutes les tables ont un id (BIGINT AUTO_INCREMENT) comme clé primaire.
• La plupart des tables ont un champ uuid (CHAR(36)) pour l'intégration avec des systèmes externes.
• Les tables d'association n'ont généralement que id et deux champs de clé étrangère.
• Les champs JSON utilisent le type LONGTEXT, stockant des chaînes JSON formatées.

2. myems_historical_db (Base de données historique)

Usage : stocke les données temps-réel et l’historique ; c’est l’une des bases les plus volumineuses du système.

Caractéristiques :

• Volume très important, stockage en séries temporelles
• Tables de valeurs brutes et tables « latest » pour accès rapide
• Marqueurs de qualité (is_bad, is_published)

Structure principale :

Table	Description	Champs clés	Stratégie d’index
tbl_analog_value	Historique analogique	point_id, utc_date_time, actual_value, is_bad, is_published	(point_id, utc_date_time), (utc_date_time)
tbl_analog_value_latest	Dernière valeur analogique (cache)	point_id, utc_date_time, actual_value	(point_id, utc_date_time)
tbl_digital_value	Historique digital	point_id, utc_date_time, actual_value (INT)	(point_id, utc_date_time), (utc_date_time)
tbl_digital_value_latest	Dernière valeur digital	point_id, utc_date_time, actual_value	(point_id, utc_date_time)
tbl_energy_value	Historique énergétique	point_id, utc_date_time, actual_value, is_bad, is_published	(point_id, utc_date_time), (utc_date_time)
tbl_energy_value_latest	Dernière valeur énergétique	point_id, utc_date_time, actual_value	(point_id, utc_date_time)
tbl_text_value	Historique texte	point_id, utc_date_time, actual_value (LONGTEXT)	(point_id, utc_date_time), (utc_date_time)
tbl_text_value_latest	Dernière valeur texte	point_id, utc_date_time, actual_value	(point_id, utc_date_time)

Tables de fichiers :

Table	Description	Champs clés
tbl_cost_files	Fichiers de coût (Excel/CSV)	file_name, uuid, upload_datetime_utc, status, file_object (LONGBLOB)
tbl_offline_meter_files	Fichiers compteurs hors-ligne	file_name, uuid, upload_datetime_utc, status, file_object
tbl_data_repair_files	Fichiers de réparation de données	file_name, uuid, upload_datetime_utc, status, file_object
tbl_energy_plan_files	Fichiers de plan énergétique	file_name, uuid, upload_datetime_utc, status, file_object

Types de données :

• actual_value : DECIMAL(21, 6) – haute précision, 6 décimales
• utc_date_time : DATETIME – toujours en UTC
• is_bad : BOOL – True = donnée invalide
• is_published : BOOL – True = donnée publiée

Notes développement :

• Toutes les dates sont UTC ; convertir côté front
• Les tables _latest évitent le scan de l’historique
• Tables fichier en LONGBLOB – attention à la taille
• Nettoyage régulier pour préserver les perfs

---

3. myems_energy_db (Base de données énergie)

Usage : agrège les consommations par heure, jour, mois, année pour tous les équipements.

Caractéristiques :

• Données calculées par le service myems-aggregation
• Granularités : hourly, daily, monthly, yearly
• Stats par catégorie énergétique et par poste

Règle de nommage : tbl_{type}_{flux}_{cat/item}_{granularité}
type : meter, equipment, combined_equipment, space, store, tenant, shopfloor
flux : input / output
granularité : hourly, daily, monthly, yearly

3.1 Consommation des compteurs

Table	Description	Champs clés
tbl_meter_hourly	Conso horaire compteur	meter_id, start_datetime_utc, actual_value
tbl_meter_daily	Conso journalière	meter_id, start_datetime_utc, actual_value
tbl_meter_monthly	Conso mensuelle	meter_id, start_datetime_utc, actual_value
tbl_meter_yearly	Conso annuelle	meter_id, start_datetime_utc, actual_value
tbl_offline_meter_hourly	Conso horaire compteur hors-ligne	offline_meter_id, start_datetime_utc, actual_value
tbl_virtual_meter_hourly	Conso horaire compteur virtuel	virtual_meter_id, start_datetime_utc, actual_value

3.2 Consommation des équipements

Table	Description	Champs clés
tbl_equipment_input_category_hourly	Entrée équip. par catégorie	equipment_id, energy_category_id, start_datetime_utc, actual_value
tbl_equipment_input_item_hourly	Entrée équip. par poste	equipment_id, energy_item_id, start_datetime_utc, actual_value
tbl_equipment_output_category_hourly	Sortie équip. par catégorie	equipment_id, energy_category_id, start_datetime_utc, actual_value
tbl_combined_equipment_input_category_hourly	Entrée équip. combiné	combined_equipment_id, energy_category_id, start_datetime_utc, actual_value
tbl_combined_equipment_output_category_hourly	Sortie équip. combiné	combined_equipment_id, energy_category_id, start_datetime_utc, actual_value

3.3 Consommation des espaces

Table	Description	Champs clés
tbl_space_input_category_hourly	Entrée espace par catégorie	space_id, energy_category_id, start_datetime_utc, actual_value
tbl_space_input_item_hourly	Entrée espace par poste space_id, energy_item_id, start_datetime_utc, actual_value
tbl_space_output_category_hourly	Entrée espace par poste	space_id, energy_category_id, start_datetime_utc, actual_value
tbl_store_input_category_hourly	Entrée magasin	store_id, energy_category_id, start_datetime_utc, actual_value
tbl_tenant_input_category_hourly	Entrée tenant	tenant_id, energy_category_id, start_datetime_utc, actual_value
tbl_shopfloor_input_category_hourly	Entrée atelier	shopfloor_id, energy_category_id, start_datetime_utc, actual_value

3.4 Énergies renouvelables & stockage

Table	Description	Champs clés
tbl_photovoltaic_power_station_hourly	Prod. horaire PV	photovoltaic_power_station_id, start_datetime_utc, actual_value
tbl_energy_storage_container_charge_hourly	Charge batterie	energy_storage_container_id, start_datetime_utc, actual_value
tbl_energy_storage_container_discharge_hourly	Décharge batterie	energy_storage_container_id, start_datetime_utc, actual_value
tbl_energy_storage_container_grid_buy_hourly	Achat réseau	energy_storage_container_id, start_datetime_utc, actual_value
tbl_energy_storage_container_grid_sell_hourly	Vente réseau	energy_storage_container_id, start_datetime_utc, actual_value
tbl_microgrid_charge_hourly	Charge micro-réseau	microgrid_id, start_datetime_utc, actual_value
tbl_microgrid_discharge_hourly	Décharge micro-réseau	microgrid_id, start_datetime_utc, actual_value

Index : Index composite : (objet_id, catégorie_id, start_datetime_utc) ou (objet_id, start_datetime_utc)

Notes développement :

• start_datetime_utc = début de la période (ex. 00:00:00 pour 00-01h)
• actual_value = valeur agrégée, non brute
• Données calculées périodiquement, pas en temps réel
• Gestion des fuseaux horaires côté requête

4. myems_billing_db (Base de Données de Facturation)

Usage : Stocke les données de consommation d'énergie liées à la facturation. Structure similaire à myems_energy_db, mais les données sont calculées avec les tarifs appliqués.

Caractéristiques :

• Structure de table identique à myems_energy_db
• Les données sont calculées par le service myems-aggregation en fonction de la configuration des tarifs
• Prend en charge des règles de facturation complexes telles que les tarifs temporels, les tarifs progressifs, etc.

Tables Principales :

• Structure de table identique à myems_energy_db
• Les valeurs des données sont multipliées par le tarif correspondant, l'unité est généralement monétaire (par exemple, Yuan, Dollar)

Considérations pour le Développement :

• Les données de facturation dépendent de la configuration des tarifs dans myems_system_db.tbl_tariffs
• Nécessite une association avec le centre de coût (cost_center)
• Prend en charge plusieurs stratégies tarifaires (temporelle, progressive, de capacité, etc.)

---

5. myems_carbon_db (Base de Données des Émissions de Carbone)

Usage : Stocke les données de consommation d'énergie liées aux émissions de carbone, utilisées pour le calcul de l'empreinte carbone.

Caractéristiques :

• Structure de table identique à myems_energy_db
• Les données sont calculées par le service myems-aggregation en fonction des facteurs d'émission de carbone
• Les facteurs d'émission de carbone sont stockés dans myems_system_db.tbl_energy_categories.kgco2e

Tables Principales :

• Structure de table identique à myems_energy_db
• Les valeurs des données sont multipliées par le facteur d'émission de carbone, l'unité est généralement le kgCO2e (kilogramme d'équivalent CO2)

Considérations pour le Développement :

• Les facteurs d'émission de carbone peuvent varier dans le temps, nécessitant la prise en charge des facteurs historiques
• Les facteurs d'émission diffèrent selon le type d'énergie (électricité, gaz, pétrole, etc.)
• Prend en charge le calcul des émissions de carbone de scope 1, scope 2 et scope 3

---

6. myems_energy_baseline_db (Base de Données de Référence Énergétique)

Usage : Stocke les données de référence de consommation d'énergie, utilisées pour l'analyse des économies d'énergie et l'évaluation de l'efficacité énergétique.

Caractéristiques :

• Structure de table similaire à myems_energy_db
• Les données de référence sont généralement calculées sur la base de données historiques ou de valeurs standard
• Utilisées pour comparer la consommation réelle à la consommation de référence et calculer les économies d'énergie

Tables Principales :

• Structure de table identique à myems_energy_db
• Stocke les valeurs de référence plutôt que les valeurs réelles

Considérations pour le Développement :

• Les données de référence doivent être mises à jour régulièrement
• Prend en charge plusieurs méthodes de calcul de référence (moyenne historique, analyse de régression, valeur standard, etc.)

---

7. myems_energy_model_db (Base de Données du Modèle Énergétique)

Usage : Stocke les données du modèle de consommation énergétique annuel sur 8760 heures (nombre d'heures dans une année).

Caractéristiques :

• Stocke 8760 enregistrements par objet (données horaires pour une année)
• Utilisé pour la prévision et la planification de la consommation d'énergie
• Les noms des tables contiennent le suffixe _8760

Tables Principales :

Nom de la Table	Description	Champs Clés
tbl_meter_8760	Modèle 8760h du compteur	meter_id, start_datetime_utc, actual_value
tbl_equipment_input_category_8760	Modèle de consommation d'énergie en entrée de l'équipement	equipment_id, energy_category_id, start_datetime_utc, actual_value
tbl_combined_equipment_input_category_8760	Modèle de consommation d'énergie en entrée de l'équipement combiné	combined_equipment_id, energy_category_id, start_datetime_utc, actual_value
tbl_space_input_category_8760	Modèle de consommation d'énergie en entrée de l'espace	space_id, energy_category_id, start_datetime_utc, actual_value
tbl_shopfloor_input_category_8760	Modèle de consommation d'énergie en entrée de l'atelier	shopfloor_id, energy_category_id, start_datetime_utc, actual_value
tbl_store_input_category_8760	Modèle de consommation d'énergie en entrée du magasin	store_id, energy_category_id, start_datetime_utc, actual_value
tbl_tenant_input_category_8760	Modèle de consommation d'énergie en entrée du locataire	tenant_id, energy_category_id, start_datetime_utc, actual_value

Considérations pour le Développement :

• Le modèle 8760h est généralement généré à partir de données historiques ou de modèles standard
• Utilisé pour la prévision de la consommation annuelle et l'établissement du budget
• Permet la visualisation par semaine, mois, trimestre, etc.

---

8. myems_energy_plan_db (Base de Données du Plan Énergétique)

Usage : Stocke les données du plan et des objectifs de consommation d'énergie.

Caractéristiques :

• Structure de table similaire à myems_energy_db
• Stocke les valeurs planifiées plutôt que les valeurs réelles
• Utilisé pour le budget énergétique et la gestion des objectifs

Tables Principales :

• Structure de table identique à myems_energy_db
• Les données proviennent de fichiers de plan ou de saisies manuelles

Considérations pour le Développement :

• Les données planifiées doivent être comparées et analysées avec les données réelles
• Prend en charge la planification multi-niveaux (annuelle, mensuelle, hebdomadaire, etc.)

---

9. myems_energy_prediction_db (Base de Données de Prédiction Énergétique)

Usage : Stocke les données de prévision de consommation d'énergie.

Caractéristiques :

• Structure de table similaire à myems_energy_db
• Stocke les valeurs prédites plutôt que les valeurs réelles
• Utilisé pour la prévision et l'alerte sur la consommation d'énergie

Tables Principales :

• Structure de table identique à myems_energy_db
• Les données sont générées par des algorithmes de prédiction

Considérations pour le Développement :

• Les données de prédiction doivent être mises à jour régulièrement
• Prend en charge plusieurs algorithmes de prédiction (séries temporelles, apprentissage automatique, etc.)
• La précision des prévisions doit être optimisée en continu

---

10. myems_fdd_db (Base de Données de Détection et de Diagnostic de Défauts - FDD)

Usage : Stocke les données liées à la détection et au diagnostic de défauts.

Caractéristiques :

• Prend en charge plusieurs canaux d'alerte (Web, Email, SMS, WeChat, Appel téléphonique)
• Le moteur de règles prend en charge une logique complexe de détection de défauts
• Prend en charge l'acquittement et le traitement des messages d'alerte

Structure Principale des Tables :

Nom de la Table	Description	Champs Clés
tbl_rules	Règles de diagnostic	id, name, category, fdd_code, priority, channel, expression (JSON), message_template, is_enabled
tbl_web_messages	Messages Web	id, rule_id, user_id, subject, category, priority, message, status, belong_to_object_type, belong_to_object_id
tbl_email_messages	Messages Email	id, rule_id, recipient_name, recipient_email, subject, message, attachment_file_name, status
tbl_text_messages_outbox	Boîte d'envoi des SMS	id, rule_id, recipient_mobile, message, status, acknowledge_code
tbl_text_messages_inbox	Boîte de réception des SMS	id, sender_mobile, message, status
tbl_wechat_messages_outbox	Boîte d'envoi des messages WeChat	id, rule_id, recipient_openid, message_template_id, message_data (JSON)
tbl_wechat_messages_inbox	Boîte de réception des messages WeChat	id, sender_openid, message, status
tbl_email_servers	Configuration du serveur de messagerie	id, host, port, requires_authentication, user_name, password, from_addr
tbl_wechat_configs	Configuration WeChat	id, api_server, app_id, app_secret, access_token, expires_datetime_utc

Catégories de Règles (category) :

• REALTIME : Alerte en temps réel
• SYSTEM : Alerte système
• SPACE : Alerte spatiale
• METER : Alerte de compteur
• TENANT : Alerte de locataire
• STORE : Alerte de magasin
• SHOPFLOOR : Alerte d'atelier
• EQUIPMENT : Alerte d'équipement
• COMBINEDEQUIPMENT : Alerte d'équipement combiné

Priorités (priority) :

• CRITICAL : Critique
• HIGH : Élevée
• MEDIUM : Moyenne
• LOW : Faible

Considérations pour le Développement :

• Le champ expression stocke l'expression de la règle au format JSON
• message_template prend en charge le remplacement de variables (comme $name, $value)
• Les règles prennent en charge l'exécution planifiée et immédiate
• Statut du message : new → sent → acknowledged / timeout

---

11. myems_user_db (Base utilisateurs)

Usage : authentification, clés API, messages e-mail, etc.

Caractéristiques :

• Faible volume, haute sécurité
• Gestion des droits utilisateurs
• Authentification par clé API

Structure principale :

Table	Description	Champs clés
tbl_users	Utilisateurs	id, name, uuid, display_name, email, salt, password, is_admin, is_read_only, privilege_id, account_expiration_datetime_utc, password_expiration_datetime_utc, failed_login_count
tbl_privileges	Privilèges	id, name, data (JSON)
tbl_sessions	Sessions	id, user_uuid, token, utc_expires
tbl_api_keys	Clés API	id, name, token, created_datetime_utc, expires_datetime_utc
tbl_email_messages	E-mails	id, recipient_name, recipient_email, subject, message, attachment_file_name, status, scheduled_datetime_utc
tbl_email_message_sessions	Sessions e-mail	id, recipient_email, token, expires_datetime_utc
tbl_logs	Journal d’audit	id, user_uuid, request_datetime_utc, request_method, resource_type, resource_id, request_body (JSON)
tbl_notifications	Notifications	id, user_id, created_datetime_utc, status, subject, message, url
tbl_new_users	Nouveaux comptes (attente activation)	id, name, uuid, display_name, email, salt, password
tbl_verification_codes	Codes de vérification	id, recipient_email, verification_code, created_datetime_utc, expires_datetime_utc

Sécurité :

• Mots de passe : salt + hash, jamais en clair
• Dates d’expiration compte & mot de passe
• Limite de tentatives de connexion
• Clés API avec date d’expiration

Notes développement :

• Ne jamais lire le champ password en clair
• Nettoyer régulièrement les tokens expirés
• Conserver tous les logs pour audit
• Cycle notification : unread → read → archived

---

12. myems_reporting_db (Base rapports)

Usage : stockage des messages e-mail et pièces jointes liés aux rapports.

Caractéristiques :

• Faible volume
• Modèles et fichiers générés conservés

Structure principale :

Table	Description	Champs clés
tbl_reports	Configuration rapport	id, name, uuid, expression (JSON), is_enabled, last_run_datetime_utc, next_run_datetime_utc, is_run_immediately
tbl_reports_files	Fichiers générés	id, uuid, create_datetime_utc, file_name, file_type (xlsx/pdf/docx), file_object (LONGBLOB)
tbl_template_files	Modèles	id, uuid, report_id, file_name, file_type, file_object
tbl_email_messages	Messages e-mail	id, recipient_name, recipient_email, subject, message, attachment_file_name, attachment_file_object, status

Notes développement :

• Formats supportés : Excel, PDF, Word
• Modèles utilisés pour génération
• Génération planifiée ou immédiate
• LONGBLOB – surveiller la taille

---

13. myems_production_db (Base production)

Usage : données de production (produits, équipes, shifts…).

Caractéristiques :

• Faible volume
• Analyses d’efficacité énergétique par produit

Structure principale :

Table	Description	Champs clés
tbl_products	Produits	id, name, uuid, unit_of_measure, tag, standard_product_coefficient
tbl_teams	Équipes	id, name, uuid, description
tbl_shifts	Shifts	id, shopfloor_id, team_id, product_id, product_count, start_datetime_utc, end_datetime_utc, reference_timestamp
tbl_shopfloor_hourly	Production atelier (horaire)	id, shopfloor_id, start_datetime_utc, product_id, product_count
tbl_space_hourly	Production espace (horaire)	id, space_id, start_datetime_utc, product_id, product_count
tbl_shopfloors_products	Lien atelier-produit	id, shopfloor_id, product_id
tbl_shopfloors_teams	Lien atelier-équipe	id, shopfloor_id, team_id

Notes développement :

• Calcul consommation spécifique par produit
• Statistiques par produit, équipe, atelier
• Corrélation avec les données énergétiques pour indicateurs d’efficacité

Relations de Flux de Données

Processus d'Acquisition des Données

Équipements/Capteurs
    ↓ (Modbus TCP/MQTT/HTTP)
myems-modbus-tcp (Service d'acquisition de données)
    ↓ (Écriture)
myems_historical_db.tbl_analog_value / tbl_digital_value / tbl_energy_value
    ↓ (Normalisation des données)
myems-normalization (Service de normalisation des données)
    ↓ (Nettoyage des données)
myems-cleaning (Service de nettoyage des données)
    ↓ (Agrégation des données)
myems-aggregation (Service d'agrégation des données)
    ↓ (Écriture)
myems_energy_db (Données de consommation d'énergie)
myems_billing_db (Données de facturation)
myems_carbon_db (Données d'émissions de carbone)

Processus de Requête des Données

Requête Utilisateur
    ↓
myems-api (Service API)
    ↓ (Requête)
myems_system_db (Données de configuration)
myems_historical_db (Données historiques)
myems_energy_db (Données de consommation d'énergie)
    ↓ (Retour)
myems-web / myems-admin (Affichage frontal)

Relations des Données

myems_system_db.tbl_points
    ↓ (point_id)
myems_historical_db.tbl_analog_value
    ↓ (Calcul d'agrégation)
myems_energy_db.tbl_meter_hourly
    ↓ (Relation)
myems_system_db.tbl_meters
    ↓ (Relation)
myems_system_db.tbl_equipments
    ↓ (Relation)
myems_system_db.tbl_spaces

---

Normes de Conception de la Structure des Tables

Champs Universels

Toutes les tables incluent les champs universels suivants :

Nom du Champ	Type	Description
id	BIGINT NOT NULL AUTO_INCREMENT	Clé primaire, auto-incrémentée
name	VARCHAR(255)	Nom
uuid	CHAR(36)	UUID, pour l'intégration avec des systèmes externes
description	VARCHAR(255)	Description (optionnelle)

Champs Temporels

Nom du Champ	Type	Description
utc_date_time	DATETIME	Heure UTC (tables de données historiques)
start_datetime_utc	DATETIME	Heure de début de la période (tables de données agrégées)
created_datetime_utc	DATETIME	Heure de création
updated_datetime_utc	DATETIME	Heure de mise à jour
last_run_datetime_utc	DATETIME	Heure de la dernière exécution
next_run_datetime_utc	DATETIME	Heure de la prochaine exécution

Remarque : Tous les champs temporels utilisent uniformément l'heure UTC. La conversion vers l'heure locale est effectuée par l'interface frontale pour l'affichage.

Champs Numériques

Nom du Champ	Type	Description
actual_value	DECIMAL(21, 6)	Valeur réelle, supporte une haute précision (6 décimales)
set_value	DECIMAL(21, 6)	Valeur de consigne
rated_capacity	DECIMAL(21, 6)	Capacité nominale
rated_power	DECIMAL(21, 6)	Puissance nominale

Champs JSON

Nom du Champ	Type	Description
connection	LONGTEXT	Configuration de connexion (format JSON)
expression	LONGTEXT	Expression (format JSON)
payload	LONGTEXT	Charge utile (format JSON)
data	LONGTEXT	Données (format JSON)

Remarque : Les champs JSON stockent des chaînes JSON formatées et doivent être analysés avant utilisation.

Champs d'État

Nom du Champ	Type	Description
is_enabled	BOOL	Est activé
is_active	BOOL	Est actif
is_bad	BOOL	Est une donnée erronée
is_published	BOOL	Est publié
is_counted	BOOL	Est comptabilisé dans les statistiques
status	VARCHAR(32)	Statut (ex: new, sent, done, error)

Conception des Index

Index Primaire :

• Toutes les tables ont une PRIMARY KEY (id)

Index Unique :

• Les champs clés (comme name, uuid) ont généralement un index unique

Index Composite :

• Les combinaisons de champs fréquemment interrogées utilisent un index composite
• Ex: (point_id, utc_date_time), (meter_id, start_datetime_utc)

Index Temporel :

• Les champs temporels sont généralement indexés séparément pour supporter les requêtes par plage de temps