MyEMS Conception de la base de données
Sommaire
- Architecture des bases
- Description détaillée
- 1. Base système (myems_system_db)
- 2. Base historique (myems_historical_db)
- 3. Base énergie (myems_energy_db)
- 4. Base de facturation (myems_billing_db)
- 5. Base carbone (myems_carbon_db)
- 6. Base de réf érence énergétique (myems_energy_baseline_db)
- 7. Base de modèle énergétique (myems_energy_model_db)
- 8. Base de plan énergétique (myems_energy_plan_db)
- 9. Base de prévision énergétique (myems_energy_prediction_db)
- 10. Base FDD (myems_fdd_db)
- 11. Base utilisateurs (myems_user_db)
- 12. Base de rapports (myems_reporting_db)
- 13. Base de production (myems_production_db)
- Flux de données
- Règles de structure des tables
Architecture des bases
MyEMS utilise 13 bases MySQL. Les scripts d'installation sont dans database/install. Chaque script crée une base en utf8mb4 / utf8mb4_unicode_ci. Les tables utilisent une clé primaire BIGINT, des colonnes DATETIME en UTC et DECIMAL(21, 6) pour les mesures et les agrégats.
| Base | Tables | Rôle |
|---|---|---|
myems_system_db | 166 | Données de référence : espaces, compteurs, points, équipements, centrales, tarifs et associations |
myems_historical_db | 12 | Valeurs brutes des points et fichiers importés de coût, de compteurs hors ligne, de réparation et de plan |
myems_energy_db | 39 | Agrégation horaire de l'énergie |
myems_billing_db | 39 | Agrégation horaire des coûts, même jeu de tables que l'énergie |
myems_carbon_db | 39 | Agrégation horaire du carbone, même jeu de tables que l'énergie |
myems_energy_baseline_db | 39 | Référence horaire, même jeu de tables que l'énergie |
myems_energy_model_db | 39 | Année type de 8 760 heures, mêmes objets que l'énergie |
myems_energy_plan_db | 39 | Plan horaire, même jeu de tables que l'énergie |
myems_energy_prediction_db | 39 | Prévision horaire, même jeu de tables que l'énergie |
myems_fdd_db | 9 | Règles de défaut et messages e-mail, SMS, web et WeChat |
myems_user_db | 10 | Utilisateurs, privilèges, sessions, clés d'API et journaux d'audit |
myems_reporting_db | 4 | Définitions de rapports, modèles, fichiers générés et e-mails de rapport |
myems_production_db | 8 | Produits, équipes, postes et quantités horaires |
Principe
| Base | Responsabilité | Écrivain |
|---|---|---|
myems_system_db | Configuration et topologie | Interface web via myems-api |
myems_historical_db | Séries des points et classeurs importés | Acquisition et import de fichiers |
myems_energy_db | Énergie horaire | Normalisation et agrégation |
myems_billing_db | Coût horaire | Facturation, à partir de l'énergie et des tarifs |
myems_carbon_db | Émissions horaires | Calcul carbone, à partir de l'énergie et des facteurs d'émission |
myems_energy_baseline_db | Référence horaire | Service de référence |
myems_energy_model_db | Une valeur par heure d'une année non bissextile | Service de modélisation |
myems_energy_plan_db | Plan horaire | Service de planification |
myems_energy_prediction_db | Prévision horaire | Service de prévision |
myems_fdd_db | Règles et notifications sortantes | Service FDD |
myems_user_db | Identité et privilèges | API |
myems_reporting_db | Rapports planifiés | Service de rapports |
myems_production_db | Quantités produites pour l'intensité énergétique | Import et agrégation de production |
Les objets de configuration se référencent par id. Les tables d'une autre base stockent le même id et ne déclarent pas de clé étrangère vers une autre base.
Conventions de nommage
| Objet | Règle | Exemple |
|---|---|---|
| Base | préfixe myems_, suffixe _db | myems_system_db |
| Table | préfixe tbl_ | tbl_meters |
| Table d'association | tbl_{owner}_{child} | tbl_spaces_meters |
| Table de faits horaire | {object}_{measure}_hourly | tbl_meter_hourly |
| Table de faits du modèle | même ensemble d'objets, suffixe _8760 | tbl_meter_8760 |
| Clé primaire | id | id BIGINT NOT NULL AUTO_INCREMENT |
| Clé métier | uuid CHAR(36) sur les objets de configuration | compteur, espace, équipement |
| Temps | *_datetime_utc ou utc_date_time | start_datetime_utc |
| Index | {table}_index_{n} | tbl_meters_index_1 |
Description détaillée
1. Base système (myems_system_db)
myems_system_db porte les données de référence. Elle compte 166 tables. Les objets de configuration ont en général id, name, uuid et description. Les tables d'association ne stockent que les deux clés étrangères et id. Les tables de composants d'une centrale stockent une ligne par appareil physique et une table *_points associée.
Classification de l'énergie
| Table | Champs clés | Description |
|---|---|---|
tbl_energy_categories | name, uuid, unit_of_measure, kgce, kgco2e | Catégorie d'énergie et facteurs de conversion par défaut |
tbl_energy_items | name, uuid, energy_category_id | Poste sous une catégorie |
kgce et kgco2e sont les facteurs par défaut de la catégorie. Les prix et facteurs d'émission bornés dans le temps sont dans les tables de tarifs et de facteurs.
Compteurs et points
| Table | Champs clés | Description |
|---|---|---|
tbl_meters | energy_category_id, energy_item_id, cost_center_id, master_meter_id, is_counted, is_enabled, hourly_low_limit, hourly_high_limit | Compteur en ligne |
tbl_offline_meters | mêmes limites et champs de catégorie, sans master_meter_id | Compteur saisi à la main |
tbl_virtual_meters | equation (LONGTEXT), energy_category_id, energy_item_id, is_counted, is_enabled | Compteur calculé par une équation |
tbl_variables | name, virtual_meter_id, meter_type, meter_id | Liaison de variable dans l'équation d'un compteur virtuel |
tbl_points | data_source_id, object_type, units, high_limit, low_limit, higher_limit, lower_limit, ratio, offset_constant, is_trend, is_virtual, address, faults, definitions | Point de donnée. address, faults et definitions sont du JSON. Pas de uuid |
tbl_points_set_values | point_id, utc_date_time, set_value, is_set | Valeur de consigne d'un point |
tbl_meters_points | meter_id, point_id | Liaison compteur-point |
tbl_meters_commands | meter_id, command_id | Liaison compteur-commande |
higher_limit, lower_limit et is_in_alarm de tbl_points servent au service FDD. ratio et offset_constant mettent le brut à l'échelle.
Acquisition
| Table | Champs clés | Description |
|---|---|---|
tbl_gateways | name, uuid, token, last_seen_datetime_utc | Passerelle d'acquisition |
tbl_data_sources | gateway_id, protocol, connection (LONGTEXT), process_id, last_seen_datetime_utc | Connexion sous une passerelle. connection est du JSON |
tbl_protocols | name, code | Catalogue de protocoles |
tbl_sensors | name, uuid | Capteur |
tbl_sensors_points | sensor_id, point_id | Liaison capteur-point |
tbl_iot_sim_cards | iccid, imsi, operator, status, used_traffic, total_traffic | Inventaire de cartes SIM. Cette table n'a pas de uuid |
Espaces et centres de coût
| Table | Champs clés | Description |
|---|---|---|
tbl_spaces | parent_space_id, area, number_of_occupants, timezone_id, contact_id, cost_center_id, latitude, longitude, is_input_counted, is_output_counted | Arbre des espaces |
tbl_cost_centers | name, uuid, external_id | Centre de coût |
tbl_contacts | name, uuid, email, phone | Contact |
tbl_timezones | name, utc_offset | Fuseau horaire |
tbl_working_calendars | name | Calendrier de travail |
tbl_working_calendars_non_working_days | working_calendar_id, date_local, description | Jour non travaillé |
Un espace relie ses enfants par des tables d'association, pas par une colonne space_id sur ces objets :
tbl_spaces_meters, tbl_spaces_offline_meters, tbl_spaces_virtual_meters, tbl_spaces_points, tbl_spaces_sensors, tbl_spaces_equipments, tbl_spaces_combined_equipments, tbl_spaces_commands, tbl_spaces_shopfloors, tbl_spaces_stores, tbl_spaces_tenants, tbl_spaces_charging_stations, tbl_spaces_microgrids, tbl_spaces_photovoltaic_power_stations, tbl_spaces_energy_storage_power_stations, tbl_spaces_wind_farms, tbl_spaces_distribution_systems, tbl_spaces_energy_flow_diagrams, tbl_spaces_working_calendars.
Équipements
| Table | Champs clés | Description |
|---|---|---|
tbl_equipments | is_input_counted, is_output_counted, is_enabled, cost_center_id, efficiency_indicator, svg_id, camera_url | Équipement |
tbl_combined_equipments | mêmes champs que tbl_equipments | Équipement combiné |
tbl_combined_equipments_equipments | combined_equipment_id, equipment_id | Membres d'un équipement combiné |
Les deux types lient compteurs, compteurs hors ligne, compteurs virtuels, paramètres, sources de données et commandes :
tbl_equipments_meters,tbl_equipments_offline_meters,tbl_equipments_virtual_meters,tbl_equipments_parameters,tbl_equipments_data_sources,tbl_equipments_commandstbl_combined_equipments_meters,tbl_combined_equipments_offline_meters,tbl_combined_equipments_virtual_meters,tbl_combined_equipments_parameters,tbl_combined_equipments_data_sources,tbl_combined_equipments_commands
Ateliers, magasins et locataires
| Table | Champs clés | Description |
|---|---|---|
tbl_shopfloors | area, is_input_counted, is_enabled, contact_id, cost_center_id | Atelier |
tbl_stores | address, latitude, longitude, area, store_type_id, is_input_counted, is_enabled, contact_id, cost_center_id | Magasin |
tbl_store_types | name, uuid, simplified_code | Type de magasin |
tbl_tenants | buildings, floors, rooms, area, tenant_type_id, is_input_counted, is_enabled, is_key_tenant, lease_number, lease_start_datetime_utc, lease_end_datetime_utc, is_in_lease, contact_id, cost_center_id | Locataire |
tbl_tenant_types | name, uuid, simplified_code | Type de locataire |
Chacun de ces trois objets a des tables d'association pour les compteurs, compteurs hors ligne, compteurs virtuels, points, capteurs, commandes et calendriers. Les ateliers ont aussi tbl_shopfloors_equipments.
Centrales photovoltaïques
tbl_photovoltaic_power_stations stocke station_code, address, latitude, longitude, latitude_point_id, longitude_point_id, rated_capacity, rated_power, contact_id, cost_center_id, cinq emplacements SVG (svg_id à svg5_id), is_cost_data_displayed, phase_of_lifecycle et commissioning_date.
Tables enfants :
| Table | Rôle |
|---|---|
tbl_photovoltaic_power_stations_invertors / _invertors_points | Onduleurs et leurs points |
tbl_photovoltaic_power_stations_grids / _grids_points | Raccordements réseau et leurs points |
tbl_photovoltaic_power_stations_loads / _loads_points | Charges et leurs points |
tbl_photovoltaic_power_stations_data_sources | Sources de données |
tbl_photovoltaic_power_stations_users | Utilisateurs liés |
Stockage d'énergie
tbl_energy_storage_containers stocke rated_capacity, rated_power, contact_id et cost_center_id. Tables de composants et tables *_points associées lorsqu'elles existent :
| Table de composant | Table de points |
|---|---|
tbl_energy_storage_containers_batteries (soc_point_id, power_point_id, charge_meter_id, discharge_meter_id) | — |
tbl_energy_storage_containers_power_conversion_systems | tbl_energy_storage_containers_pcses_points |
| — | tbl_energy_storage_containers_bmses_points (bms_id, point_id ; pas de table maître BMS) |
tbl_energy_storage_containers_dcdcs | tbl_energy_storage_containers_dcdcs_points |
tbl_energy_storage_containers_stses | tbl_energy_storage_containers_stses_points |
tbl_energy_storage_containers_grids | tbl_energy_storage_containers_grids_points |
tbl_energy_storage_containers_loads | tbl_energy_storage_containers_loads_points |
tbl_energy_storage_containers_hvacs | tbl_energy_storage_containers_hvacs_points |
tbl_energy_storage_containers_firecontrols | tbl_energy_storage_containers_firecontrols_points |
Aussi : tbl_energy_storage_containers_commands, tbl_energy_storage_containers_data_sources, tbl_energy_storage_containers_schedules.
tbl_energy_storage_power_stations reprend les champs de site d'une centrale photovoltaïque (address, coordonnées, capacité et puissance nominales, contact, centre de coût, cinq SVG, cycle de vie). Les conteneurs sont dans tbl_energy_storage_power_stations_containers, les utilisateurs dans tbl_energy_storage_power_stations_users.
Micro-réseaux
tbl_microgrids ajoute postal_code et serial_number aux champs de site. Tables enfants :
| Composant | Points |
|---|---|
tbl_microgrids_batteries | — |
| — | tbl_microgrids_bmses_points (bms_id, point_id ; pas de table maître BMS) |
tbl_microgrids_power_conversion_systems | tbl_microgrids_pcses_points |
tbl_microgrids_photovoltaics | tbl_microgrids_pvs_points |
tbl_microgrids_evchargers | tbl_microgrids_evchargers_points |
tbl_microgrids_generators | tbl_microgrids_generators_points |
tbl_microgrids_grids | tbl_microgrids_grids_points |
tbl_microgrids_heatpumps | tbl_microgrids_heatpumps_points |
tbl_microgrids_loads | tbl_microgrids_loads_points |
Aussi : tbl_microgrids_commands, tbl_microgrids_data_sources, tbl_microgrids_schedules, tbl_microgrids_sensors, tbl_microgrids_users.
Autres centrales et intégrateurs
| Table | Champs clés | Description |
|---|---|---|
tbl_charging_stations | adresse, coordonnées, rated_capacity, rated_power, contact, centre de coût, cinq SVG, cycle de vie | Station de recharge |
tbl_wind_farms | adresse, coordonnées, rated_power, contact, centre de coût, cinq SVG | Parc éolien |
tbl_virtual_power_plants | cost_center_id, balancing_price_point_id, svg_id | Centrale virtuelle |
tbl_virtual_power_plants_microgrids | virtual_power_plant_id, microgrid_id | Micro-réseaux d'une centrale virtuelle |
tbl_power_integrators | power_point_id, result_point_id, is_enabled | Intègre la puissance en énergie |
tbl_fuel_integrators | model, power_point_id, result_point_id, is_enabled | Intégrateur de combustible |
tbl_heat_integrators | high_temperature_point_id, low_temperature_point_id, flow_point_id, heat_capacity, liquid_density, coefficient, result_point_id, is_enabled | Intégrateur de chaleur |
Commandes et régulation
| Table | Champs clés | Description |
|---|---|---|
tbl_commands | topic, payload (LONGTEXT), set_value | Définition de commande |
tbl_control_modes | name, uuid, is_active | Mode de régulation |
tbl_control_modes_times | control_mode_id, start_time_of_day, end_time_of_day, power_value, power_point_id, power_equation | Une période d'un mode de régulation |
Tarifs et facteurs d'émission
| Table | Champs clés | Description |
|---|---|---|
tbl_tariffs | energy_category_id, tariff_type, unit_of_price, valid_from_datetime_utc, valid_through_datetime_utc | Tarif. tariff_type vaut timeofuse |
tbl_tariffs_timeofuses | tariff_id, start_time_of_day, end_time_of_day, peak_type, price DECIMAL(23, 8) | Prix d'une période de la journée. peak_type vaut toppeak, onpeak, midpeak, offpeak ou deep |
tbl_cost_centers_tariffs | cost_center_id, tariff_id | Liaison de tarif |
tbl_emission_factors | energy_category_id, unit_of_factor, valid_from_datetime_utc, valid_through_datetime_utc | Facteur d'émission borné dans le temps |
tbl_emission_factors_timeofuses | emission_factor_id, start_time_of_day, end_time_of_day, factor | Facteur d'une période de la journée |
tbl_cost_centers_emission_factors | cost_center_id, emission_factor_id | Liaison de facteur |
Schémas, menus, fichiers et ordres de travail
| Table | Champs clés | Description |
|---|---|---|
tbl_distribution_systems | name, uuid, svg_id | Réseau de distribution |
tbl_distribution_circuits | distribution_system_id, distribution_room, switchgear, peak_load, peak_current, customers, meters | Circuit |
tbl_distribution_circuits_points | distribution_circuit_id, point_id | Points du circuit |
tbl_energy_flow_diagrams | name, uuid | Diagramme de flux d'énergie |
tbl_energy_flow_diagrams_nodes | energy_flow_diagram_id, name | Nœud |
tbl_energy_flow_diagrams_links | energy_flow_diagram_id, source_node_id, target_node_id, meter_uuid | Lien |
tbl_svgs | name, uuid, source_code (LONGTEXT) | Graphique SVG |
tbl_menus | name, route, parent_menu_id, is_hidden | Arbre de menus. Pas de uuid |
tbl_knowledge_files | file_name, uuid, upload_datetime_utc, upload_user_uuid, file_object (LONGBLOB) | Fichier de base de connaissances |
tbl_work_orders | number, category, title, priority, status, belong_to_object_type, belong_to_object_id, source_type, source_id, creator_user_id, assignee_user_id, horodatages planifiés et réels | Ordre de travail |
tbl_work_order_logs | work_order_id, user_id, action, from_status, to_status, comment, created_datetime_utc | Journal d'état |
tbl_work_order_files | work_order_id, file_name, file_path, file_size, uploaded_by_user_id | Chemin de pièce jointe. Les octets sont sur disque |
tbl_versions | version, release_date | Version du schéma |
2. Base historique (myems_historical_db)
myems_historical_db stocke les valeurs brutes des points et les classeurs importés. Elle compte 12 tables.
Chaque famille de valeurs a une table d'historique et une table de dernière valeur. Les lignes d'historique portent is_bad et is_published. Les dernières valeurs ne gardent que point_id, utc_date_time et actual_value. Les deux sont indexées par (point_id, utc_date_time) et par utc_date_time.
| Table | Type de actual_value | Description |
|---|---|---|
tbl_analog_value, tbl_analog_value_latest | DECIMAL(21, 6) | Analogique |
tbl_energy_value, tbl_energy_value_latest | DECIMAL(21, 6) | Énergie cumulée |
tbl_digital_value, tbl_digital_value_latest | INT | Numérique |
tbl_text_value, tbl_text_value_latest | LONGTEXT | Texte |
Les fichiers importés partagent file_name, uuid, upload_datetime_utc, status (new, done, error) et file_object (LONGBLOB) :
| Table | Rôle |
|---|---|
tbl_cost_files | Classeur de coûts |
tbl_offline_meter_files | Classeur de compteurs hors ligne |
tbl_data_repair_files | Classeur de réparation |
tbl_energy_plan_files | Classeur de plan énergétique |
3. Base énergie (myems_energy_db)
myems_energy_db stocke l'énergie réelle horaire. Elle compte 39 tables, sans tables journalières, mensuelles ni annuelles. Les rapports cumulent les heures dans la requête.
Chaque table a id, l'identifiant de l'objet parent, start_datetime_utc et actual_value DECIMAL(21, 6). Les tables de catégorie ont aussi energy_category_id. Les tables de poste ont aussi energy_item_id. L'index composé est (object_id, [id de catégorie ou de poste], start_datetime_utc).
| Groupe | Tables |
|---|---|
| Compteurs | tbl_meter_hourly, tbl_offline_meter_hourly, tbl_virtual_meter_hourly |
| Équipement | tbl_equipment_input_category_hourly, tbl_equipment_input_item_hourly, tbl_equipment_output_category_hourly |
| Équipement combiné | tbl_combined_equipment_input_category_hourly, tbl_combined_equipment_input_item_hourly, tbl_combined_equipment_output_category_hourly |
| Espace | tbl_space_input_category_hourly, tbl_space_input_item_hourly, tbl_space_output_category_hourly |
| Atelier | tbl_shopfloor_input_category_hourly, tbl_shopfloor_input_item_hourly |
| Magasin | tbl_store_input_category_hourly, tbl_store_input_item_hourly |
| Locataire | tbl_tenant_input_category_hourly, tbl_tenant_input_item_hourly |
| Conteneur de stockage | tbl_energy_storage_container_{charge,discharge,grid_buy,grid_sell,load}_hourly |
| Centrale de stockage | tbl_energy_storage_power_station_{charge,discharge,grid_buy,grid_sell,load}_hourly |
| Micro-réseau | tbl_microgrid_{charge,discharge,evcharger,grid_buy,grid_sell,load,photovoltaic}_hourly |
| Centrale photovoltaïque | tbl_photovoltaic_power_station_{generation,grid_buy,grid_sell,load}_hourly |
Les tables de compteurs, compteurs hors ligne, compteurs virtuels, stockage, micro-réseau et photovoltaïque n'ont pas de colonne de catégorie d'énergie. La catégorie vient de l'objet parent.
4. Base de facturation (myems_billing_db)
myems_billing_db a les mêmes 39 tables horaires et les mêmes colonnes que myems_energy_db. actual_value est le coût dans la devise du tarif. La facturation lit l'énergie horaire et le tarif lié au centre de coût.
5. Base carbone (myems_carbon_db)
myems_carbon_db a les mêmes 39 tables horaires. actual_value est l'émission. Le calcul utilise l'énergie horaire avec tbl_energy_categories.kgco2e ou les lignes horaires de tbl_emission_factors.
6. Base de référence énergétique (myems_energy_baseline_db)
myems_energy_baseline_db a les mêmes 39 tables horaires. actual_value est la référence de cette heure.
7. Base de modèle énergétique (myems_energy_model_db)
myems_energy_model_db a les mêmes 39 groupes d'objets. Les noms de tables se terminent par _8760 et non _hourly, et la colonne de temps est hour_of_year (INT) et non start_datetime_utc. Exemple : tbl_meter_8760(meter_id, hour_of_year, actual_value).
8. Base de plan énergétique (myems_energy_plan_db)
myems_energy_plan_db a les mêmes 39 tables horaires que myems_energy_db. actual_value est la quantité planifiée. Les classeurs de plan arrivent d'abord dans myems_historical_db.tbl_energy_plan_files.
9. Base de prévision énergétique (myems_energy_prediction_db)
myems_energy_prediction_db a les mêmes 39 tables horaires. actual_value est la quantité prévue.
10. Base FDD (myems_fdd_db)
myems_fdd_db compte 9 tables.
| Table | Champs clés | Description |
|---|---|---|
tbl_rules | name, uuid, category, fdd_code, priority, channel, expression, message_template, is_enabled, last_run_datetime_utc, next_run_datetime_utc, is_run_immediately | Règle de défaut. expression est du JSON. message_template est du texte avec substitutions $ |
tbl_email_servers | host, port, requires_authentication, user_name, password, from_addr | Serveur SMTP |
tbl_email_messages | rule_id, recipient_email, subject, message, attachment_file_object, scheduled_datetime_utc, status | E-mail sortant |
tbl_text_messages_outbox | rule_id, recipient_mobile, message, acknowledge_code, status | SMS sortant |
tbl_text_messages_inbox | sender_mobile, message, received_datetime_utc, status | SMS entrant |
tbl_web_messages | rule_id, user_id, subject, category, priority, message, status, reply, belong_to_object_type, belong_to_object_id | Message web |
tbl_wechat_configs | api_server, app_id, app_secret, access_token, expires_datetime_utc | Application WeChat |
tbl_wechat_messages_outbox | rule_id, recipient_openid, message_template_id, message_data, status | WeChat sortant |
tbl_wechat_messages_inbox | sender_openid, message, received_datetime_utc, status | WeChat entrant |
tbl_rules.category vaut REALTIME, SYSTEM, SPACE, METER, TENANT, STORE, SHOPFLOOR, EQUIPMENT ou COMBINEDEQUIPMENT. priority vaut CRITICAL, HIGH, MEDIUM ou LOW. channel vaut WEB, EMAIL, SMS, WECHAT ou CALL. fdd_code identifie la règle, par exemple REALTIME01 ou SPACE02.
11. Base utilisateurs (myems_user_db)
myems_user_db compte 10 tables.
| Table | Champs clés | Description |
|---|---|---|
tbl_users | name, uuid, display_name, email, phone, salt, password, is_admin, is_read_only, privilege_id, account_expiration_datetime_utc, password_expiration_datetime_utc, failed_login_count | Utilisateur. password est le hachage salé (VARCHAR(256)) |
tbl_privileges | name, data (LONGTEXT, JSON) | Jeu de privilèges |
tbl_sessions | user_uuid, token, utc_expires | Session de connexion |
tbl_logs | user_uuid, request_datetime_utc, request_method, resource_type, resource_id, request_body | Journal d'audit de l'API. request_body est du JSON |
tbl_api_keys | name, token, created_datetime_utc, expires_datetime_utc | Clé d'API. id est INT |
tbl_new_users | name, uuid, display_name, email, salt, password | Inscription en attente |
tbl_email_messages | recipient_email, subject, message, scheduled_datetime_utc, status | Courriel utilisateur, par exemple réinitialisation du mot de passe. status vaut new, sent ou timeout |
tbl_email_message_sessions | recipient_email, token, expires_datetime_utc | Jeton d'une action par courriel |
tbl_verification_codes | recipient_email, verification_code, created_datetime_utc, expires_datetime_utc | Code de vérification. id est INT |
tbl_notifications | user_id, created_datetime_utc, status, subject, message, url | Notification dans l'application. status vaut unread, read ou archived |
12. Base de rapports (myems_reporting_db)
myems_reporting_db compte 4 tables.
| Table | Champs clés | Description |
|---|---|---|
tbl_reports | name, uuid, expression, is_enabled, last_run_datetime_utc, next_run_datetime_utc, is_run_immediately | Planification de rapport. expression est du JSON |
tbl_template_files | uuid, report_id, file_name, file_type, file_object | Modèle lié à un rapport |
tbl_reports_files | uuid, create_datetime_utc, file_name, file_type, file_object | Fichier généré |
tbl_email_messages | recipient_email, subject, message, attachment_file_object, scheduled_datetime_utc, status | Courriel d'envoi du rapport. Cette table n'a pas de rule_id |
13. Base de production (myems_production_db)
myems_production_db compte 8 tables. Les quantités horaires partagent start_datetime_utc, product_id et product_count.
| Table | Champs clés | Description |
|---|---|---|
tbl_products | name, uuid, unit_of_measure, tag, standard_product_coefficient | Produit |
tbl_teams | name, uuid, description | Équipe |
tbl_shopfloors_products | shopfloor_id, product_id | Produits fabriqués dans un atelier |
tbl_shopfloors_teams | shopfloor_id, team_id | Équipes d'un atelier |
tbl_shifts | shopfloor_id, team_id, product_id, product_count, start_datetime_utc, end_datetime_utc, reference_timestamp | Enregistrement de poste |
tbl_equipment_hourly | equipment_id, start_datetime_utc, product_id, product_count | Production horaire d'un équipement |
tbl_shopfloor_hourly | shopfloor_id, start_datetime_utc, product_id, product_count | Production horaire d'un atelier |
tbl_space_hourly | space_id, start_datetime_utc, product_id, product_count | Production horaire agrégée sur un espace |
Flux de données
Ordre de traitement :
- Les passerelles écrivent les valeurs de points dans
myems_historical_db. Les classeurs importés arrivent dans les tables de fichiers de la même base. - La normalisation transforme les valeurs de points en relevés de compteurs, avec
ratioetoffset_constantdetbl_points. - L'agrégation écrit des lignes horaires dans
myems_energy_dbpour les compteurs et pour chaque objet parent (équipement, espace, magasin, locataire, atelier, stockage, micro-réseau, centrale photovoltaïque). - La facturation multiplie ces heures par
tbl_tariffs/tbl_tariffs_timeofuseset écritmyems_billing_db. - Le carbone multiplie ces heures par
kgco2eoutbl_emission_factorset écritmyems_carbon_db. - Les services de référence, de modèle, de plan et de prévision écrivent leurs propres bases. La base de modèle stocke
hour_of_yearau lieu d'un horodatage. - Le FDD évalue
tbl_rules.expressionface aux limites des points et aux agrégats, puis met en file les messages e-mail, SMS, web ou WeChat. - Les rapports lisent l'énergie, les coûts et le carbone, remplissent
tbl_template_fileset enregistrent le résultat danstbl_reports_files. - Les quantités horaires de
myems_production_dbsont le dénominateur de l'intensité énergétique.
Règles de structure des tables
Champs communs
Les tables de configuration de myems_system_db contiennent en général :
| Champ | Type | Description |
|---|---|---|
id | BIGINT NOT NULL AUTO_INCREMENT | Clé primaire |
name | VARCHAR(128) ou VARCHAR(255) | Nom affiché |
uuid | CHAR(36) NOT NULL | Clé métier stable |
description | VARCHAR(255) | Description facultative |
Les tables de séries et d'association ne suivent pas cet ensemble. Les tables de faits utilisent id, des clés étrangères et actual_value. Beaucoup de tables d'association n'ont que id et deux clés étrangères. tbl_points, tbl_menus et tbl_iot_sim_cards n'ont pas de uuid.
Types de données
| Usage | Type |
|---|---|
| Clés primaires et étrangères | BIGINT (INT pour tbl_api_keys et tbl_verification_codes) |
| Énergie, coût, carbone, limites, surface | DECIMAL(21, 6) |
| Prix d'une période tarifaire | DECIMAL(23, 8) |
| Latitude | DECIMAL(12, 10) |
| Longitude | DECIMAL(13, 10) |
| Horodatages | DATETIME, stockés en UTC |
| Dates calendaires | DATE |
| Heure du jour | TIME |
| Indicateurs | BOOL |
| Codes courts et états | VARCHAR |
Documents JSON (address, faults, definitions, connection, expression de règle et de rapport, data de privilège, request_body) | LONGTEXT |
Équations (tbl_virtual_meters.equation, power_equation) | LONGTEXT |
| Valeur de point numérique | INT |
| Fichiers | LONGBLOB |
Index
Les index secondaires se nomment {table_name}_index_{n}.
| Motif | Exemple |
|---|---|
| Recherche par nom | tbl_meters_index_1 (name) |
| Parent plus temps | tbl_meter_hourly_index_1 (meter_id, start_datetime_utc) |
| Catégorie plus temps | tbl_space_input_category_hourly_index_1 (space_id, energy_category_id, start_datetime_utc) |
| Historique de point | tbl_analog_value_index_1 (point_id, utc_date_time), tbl_analog_value_index_2 (utc_date_time) |
| Validité du tarif | tbl_tariffs_index_2 (energy_category_id, valid_from_datetime_utc, valid_through_datetime_utc) |
Les scripts ne déclarent pas de clés étrangères. L'intégrité référentielle est assurée par l'API.