Tài liệu Thiết kế Cơ sở dữ liệu MyEMS
Tài liệu này nhắm đến các lập trình viên, cung cấp giải thích chi tiết về kiến trúc cơ sở dữ liệu, cấu trúc bảng và triết lý thiết kế của hệ thống quản lý năng lượng MyEMS.
Mục lục
- Thiết kế kiến trúc cơ sở dữ liệu
- Mô tả chi tiết cơ sở dữ liệu
- Mối quan hệ luồng dữ liệu
- Quy tắc Thiết kế Cấu trúc Bảng
Thiết kế kiến trúc cơ sở dữ liệu
Triết lý thiết kế
- Phân tách dữ liệu: Tách dữ liệu vào các cơ sở dữ liệu khác nhau dựa trên loại dữ liệu và mục đích sử dụng để tránh một cơ sở dữ liệu duy nhất trở nên quá lớn
- Phân tách đọc - ghi: Dữ liệu lịch sử được lưu trữ theo định dạng chuỗi thời gian, cho phép truy vấn hiệu quả
- Mở rộng ngang: Các cơ sở dữ liệu lớn (historical_db, energy_db) có thể được mở rộng độc lập
- Tiêu chuẩn thống nhất: Tất cả các cơ sở dữ liệu sử dụng cùng bộ ký tự và quy tắc sắp xếp
Cấu hình cơ sở dữ liệu
Tất cả các cơ sở dữ liệu đều sử dụng cấu hình sau một cách thống nhất:
- Bộ ký tự:
utf8mb4(hỗ trợ bộ ký tự UTF-8 đầy đủ, bao gồm emoji) - Quy tắc sắp xếp:
utf8mb4_unicode_ci(quy tắc sắp xếp Unicode) - Cơ sở lưu trữ: InnoDB (mặc định, hỗ trợ giao dịch và khóa ngoại)
Quy tắc đặt tên
- Đặt tên Cơ sở dữ liệu:
myems_{Chức năng}_db(chữ thường, phân tách bằng gạch dưới) - Đặt tên Bảng:
tbl_{Tên thực thể}(chữ thường, phân tách bằng gạch dưới) - Đặt tên Trường: Chữ thường, phân tách bằng gạch dưới, ví dụ:
start_datetime_utc - Đặt tên Chỉ mục:
tbl_{Tên Bảng}_index_{Số thứ tự}
Mô tả chi tiết cơ sở dữ liệu
1. Myems_system_db (cơ sở dữ liệu cấu hình hệ thống)
Mục đích: Lưu trữ cấu hình cơ bản và siêu dữ liệu của hệ thống, đóng vai tr ò là thư viện cấu hình cốt lõi của toàn bộ hệ thống.
Đặc điểm:
- Chứa nhiều bảng nhất (khoảng 150+ bảng)
- Khối lượng dữ liệu tương đối nhỏ, nhưng cấu trúc phức tạp
- Chứa nhiều bảng liên kết
Phân loại Bảng chính:
1.1 Bảng Cấu hình Cơ bản
| tên bảng | Mô tả | trường khóa |
|---|---|---|
tbl_energy_categories | Phân loại năng lượng (điện, nước, ga, lạnh, nhiệt, v.v.) | id, name, unit_of_measure, kgce, kgco2e |
tbl_energy_items | Mục con tiêu thụ năng lượng (đèn chiếu sáng, điều hòa, điện, v.v.) | id, name, energy_category_id |
tbl_cost_centers | trung tâm chi phí | id, name, external_id |
tbl_data_sources | Cấu hình Nguồn dữ liệu | id, name, gateway_id, protocol, connection |
tbl_protocols | Cấu hình Giao thức | id, name, protocol_type |
1.2 Bảng Quản lý Thiết bị
| tên bảng | Mô tả | trường khóa |
|---|---|---|
tbl_equipments | Thông tin Thiết bị | id, name, uuid, equipment_type_id, cost_center_id |
tbl_combined_equipments | Thiết bị kết hợp (kết hợp nhiều thiết bị) | id, name, is_input_counted, is_output_counted |
tbl_meters | thông tin Đồng hồ đo | id, name, uuid, energy_category_id, is_counted |
tbl_offline_meters | Đồng hồ đo ngoại tuyến (nhập thủ công) | id, name, energy_category_id |
tbl_virtual_meters | Đồng hồ ảo (Được tính toán) | id, name, expression (định dạng JSON) |
tbl_points | thông tin điểm dữ liệu | id, name, data_source_id, object_type, object_id |
1.3 Bảng Tổ chức Không gian
| tên bảng | Mô tả | trường khóa |
|---|---|---|
tbl_spaces | Thông tin Không gian (phòng, tầng, v.v.) | id, name, uuid, parent_space_id, area |
tbl_stores | Thông tin Cửa hàng | id, name, uuid, space_id |
tbl_tenants | thông tin khách thuê | id, name, uuid, space_id |
tbl_shopfloors | Thông tin Xưởng sản xuất | id, name, uuid, space_id |
1.4 Bảng Mối quan hệ Liên kết
Hệ thống sử dụng nhiều bảng liên kết để thiết lập mối quan hệ nhiều - nhiều:
tbl_equipments_meters: Liên kết giữa thiết bị và đồng hồ đotbl_equipments_offline_meters: Liên kết giữa thiết bị và đồng hồ đo ngoại tuyếntbl_equipments_virtual_meters: Liên kết giữa thiết bị và đồng hồ ảotbl_spaces_equipments: Liên kết giữa không gian và thiết bịtbl_spaces_meters: Liên kết giữa không gian và đồng hồ đotbl_combined_equipments_equipments: Liên kết giữa thiết bị kết hợp và thiết bị- v.v...
1.5 Danh sách Bảng Thiết bị Năng lượng Mới
| tên bảng | Mô tả | trường khóa |
|---|---|---|
tbl_photovoltaic_power_stations | trạm năng lượng mặt trời | id, name, capacity, contact_id |
tbl_energy_storage_containers | Bình lưu trữ năng lượng | id, name, rated_capacity, rated_power |
tbl_energy_storage_power_stations | trạm lưu trữ năng lượng | id, name, rated_capacity |
tbl_microgrids | lưới vi mô | id, name, address |
tbl_charging_stations | trạm sạc | id, name, rated_capacity, rated_power |
1.6 Bảng Điều khiển và Lập lịch
| tên bảng | Mô tả | trường khóa |
|---|---|---|
tbl_commands | lệnh điều khiển | id, name, topic, payload (định dạng JSON) |
tbl_control_modes | chế độ điều khiển | id, name, is_active |
tbl_control_modes_times | Khoảng thời gian chế độ điều khiển | id, control_mode_id, start_time_of_day, end_time_of_day |
1.7 Bảng Cấu hình Khác
tbl_contacts: Thông tin Liên hệtbl_distribution_systems: Hệ thống phân phốitbl_distribution_circuits: Mạch phân phốitbl_energy_flow_diagrams: Sơ đồ luồng năng lượngtbl_tariffs: Cấu hình giá điệntbl_working_calendars: Lịch làm việctbl_web_messages: Tin nhắn Web
Lưu ý phát triển:
- Tất cả các bảng đều có
id(BIGINT AUTO-INCREMENT) làm khóa chính - Hầu hết các bảng có trường
uuid(CHAR(36)) cho tích hợp hệ thống bên ngoài - Bảng liên kết thường chỉ có
idvà hai trường khóa ngoại - Trường JSON sử dụng kiểu
LONGTEXTđể lưu trữ chuỗi JSON định dạng
2. Myems_historics_db (Cơ sở dữ liệu Dữ liệu Lịch sử)
Mục đích: Lưu trữ dữ liệu giám sát thời gian thực và dữ liệu lịch sử, là một trong những cơ sở dữ liệu có khối lượng dữ liệu lớn nhất trong hệ thống.
Đặc điểm:
- Khối lượng dữ liệu khổng lồ, sử dụng lưu trữ chuỗi thời gian
- Chứa dữ liệu thô và bảng cache giá trị mới nhất
- Hỗ trợ đánh dấu chất lượng dữ liệu (
is_bad,is_published)
Cấu trúc Bảng chính:
| tên bảng | Mô tả | trường khóa | Chiến lược Chỉ mục |
|---|---|---|---|
tbl_analog_value | Dữ liệu lịch sử giá trị tương tự | point_id, utc_date_time, actual_value, is_bad, is_published | (point_id, utc_date_time), (utc_date_time) |
tbl_analog_value_latest | Giá trị tương tự mới nhất (cache) | point_id, utc_date_time, actual_value | (point_id, utc_date_time) |
tbl_digital_value | Dữ liệu lịch sử giá trị số | point_id, utc_date_time, actual_value (INT) | (point_id, utc_date_time), (utc_date_time) |
tbl_digital_value_latest | Giá trị số mới nhất (cache) | point_id, utc_date_time, actual_value | (point_id, utc_date_time) |
tbl_energy_value | Dữ liệu lịch sử tiêu thụ năng lượng | point_id, utc_date_time, actual_value, is_bad, is_published | (point_id, utc_date_time), (utc_date_time) |
tbl_energy_value_latest | Giá trị tiêu thụ năng lượng mới nhất (cache) | point_id, utc_date_time, actual_value | (point_id, utc_date_time) |
tbl_text_value | Dữ liệu lịch sử giá trị văn bản | point_id, utc_date_time, actual_value (LONGTEXT) | (point_id, utc_date_time), (utc_date_time) |
tbl_text_value_latest | Giá trị văn bản mới nhất (cache) | point_id, utc_date_time, actual_value | (point_id, utc_date_time) |
Bảng Lưu trữ Tệp:
| tên bảng | Mô tả | trường khóa |
|---|---|---|
tbl_cost_files | Tài liệu Chi phí (Excel/CSV) | file_name, uuid, upload_datetime_utc, status, file_object (LONGBLOB) |
tbl_offline_meter_files | Tệp dữ liệu đồng hồ đo ngoại tuyến | file_name, uuid, upload_datetime_utc, status, file_object |
tbl_data_repair_files | Tệp sửa chữa dữ liệu | file_name, uuid, upload_datetime_utc, status, file_object |
tbl_energy_plan_files | Tài liệu kế hoạch tiêu thụ năng lượng | file_name, uuid, upload_datetime_utc, status, file_object |
Mô tả Kiểu dữ liệu:
actual_value: DECIMAL(21,6) - Hỗ trợ giá trị số độ chính xác cao với 6 chữ số thập phânutc_date_time: DATETIME - Thời gian UTC, tất cả các thời gian đều sử dụng UTC một cách thống nhấtis_bad: BOOL - Đánh dấu Chất lượng dữ liệu, True chỉ dữ liệu lỗiis_published: BOOL - cờ công bố, True chỉ đã công bố
Lưu ý phát triển:
- Tất cả các trường thời gian đều sử dụng thời gian UTC, hiển thị phía frontend được chuyển đổi sang thời gian địa phương
- Bảng
_latestđược sử dụng để truy vấn nhanh giá trị mới nhất, tránh quét các bảng lịch sử - Bảng tệp sử dụng
LONGBLOBđể lưu trữ tệp nhị phân, lưu ý giới hạn kích thước - Định kỳ dọn dẹp dữ liệu lịch sử để tránh các bảng quá lớn ảnh hưởng đến hiệu suất
3. Myems_energy_db (cơ sở dữ liệu tiêu thụ năng lượng)
Mục đích: Lưu trữ số liệu thống kê tiêu thụ năng lượng của các thiết bị khác nhau và tổng hợp theo giờ, ngày, tháng và năm.
Đặc điểm:
- Dữ liệu được tính toán và tạo ra bởi dịch vụ
myems-aggregation - Được chia theo mức độ chi tiết thời gian thành các bảng hàng giờ, hàng ngày, hàng tháng và hàng năm
- Hỗ trợ thống kê theo danh mục năng lượng và mục tiêu thụ năng lượng
Quy tắc Đặt tên Bảng:
tbl_{Loại Đối tượng}_{Hướng}_{Phân loại}_{Mức độ chi tiết Thời gian}- Loại đối tượng:
meter,equipment,combined_equipment,space,store,tenant,shopfloor - Hướng:
input(nhập),output(xuất) - Phân loại:
category(danh mục năng lượng),item(mục con tiêu thụ năng lượng) - Mức độ chi tiết thời gian:
hourly,daily,monthly,yearly
Cấu trúc Bảng chính:
3.1 Bảng đồng hồ đo tiêu thụ năng lượng
| tên bảng | Mô tả | trường khóa |
|---|---|---|
tbl_meter_hourly | Tiêu thụ năng lượng hàng giờ của đồng hồ đo | meter_id, start_datetime_utc, actual_value |
tbl_meter_daily | Tiêu thụ năng lượng hàng ngày của đồng hồ đo | meter_id, start_datetime_utc, actual_value |
tbl_meter_monthly | Tiêu thụ năng lượng hàng tháng của đồng hồ đo | meter_id, start_datetime_utc, actual_value |
tbl_meter_yearly | Tiêu thụ năng lượng hàng năm của đồng hồ đo | meter_id, start_datetime_utc, actual_value |
tbl_offline_meter_hourly | Tiêu thụ năng lượng hàng giờ của đồng hồ đo ngoại tuyến | offline_meter_id, start_datetime_utc, actual_value |
tbl_virtual_meter_hourly | Tiêu thụ năng lượng hàng giờ của đồng hồ ảo | virtual_meter_id, start_datetime_utc, actual_value |
3.2 Bảng Tiêu thụ Năng lượng Thiết bị
| tên bảng | Mô tả | trường khóa |
|---|---|---|
tbl_equipment_input_category_hourly | Tiêu thụ năng lượng đầu vào Thiết bị (theo danh mục) | equipment_id, energy_category_id, start_datetime_utc, actual_value |
tbl_equipment_input_item_hourly | Tiêu thụ năng lượng đầu vào Thiết bị (theo mục) | equipment_id, energy_item_id, start_datetime_utc, actual_value |
tbl_equipment_output_category_hourly | Tiêu thụ năng lượng đầu ra Thiết bị (theo danh mục) | equipment_id, energy_category_id, start_datetime_utc, actual_value |
tbl_combined_equipment_input_category_hourly | Tiêu thụ năng lượng đầu vào Thiết bị kết hợp (theo danh mục) | combined_equipment_id, energy_category_id, start_datetime_utc, actual_value |
tbl_combined_equipment_output_category_hourly | Tiêu thụ năng lượng đầu ra Thiết bị kết hợp (theo phân loại) | combined_equipment_id, energy_category_id, start_datetime_utc, actual_value |
3.3 Bảng Tiêu thụ Năng lượng Không gian
| tên bảng | Mô tả | trường khóa |
|---|---|---|
tbl_space_input_category_hourly | Tiêu thụ năng lượng đầu vào Không gian (theo danh mục) | space_id, energy_category_id, start_datetime_utc, actual_value |
tbl_space_input_item_hourly | Tiêu thụ năng lượng đầu vào Không gian (theo mục) | space_id, energy_item_id, start_datetime_utc, actual_value |
tbl_space_output_category_hourly | Tiêu thụ năng lượng đầu ra Không gian (theo phân loại) | space_id, energy_category_id, start_datetime_utc, actual_value |
tbl_store_input_category_hourly | Tiêu thụ năng lượng đầu vào Cửa hàng | store_id, energy_category_id, start_datetime_utc, actual_value |
tbl_tenant_input_category_hourly | Khách thuê nhập tiêu thụ năng lượng | tenant_id, energy_category_id, start_datetime_utc, actual_value |
tbl_shopfloor_input_category_hourly | Tiêu thụ năng lượng đầu vào Xưởng sản xuất | shopfloor_id, energy_category_id, start_datetime_utc, actual_value |
3.4 Bảng Tiêu thụ Năng lượng Thiết bị Năng lượng Mới
| tên bảng | Mô tả | trường khóa |
|---|---|---|
tbl_photovoltaic_power_station_hourly | Lượng điện sản xuất hàng giờ của trạm năng lượng mặt trời | photovoltaic_power_station_id, start_datetime_utc, actual_value |
tbl_energy_storage_container_charge_hourly | Dung lượng sạc của bình lưu trữ năng lượng | energy_storage_container_id, start_datetime_utc, actual_value |
tbl_energy_storage_container_discharge_hourly | Dung lượng xả của bình lưu trữ năng lượng | energy_storage_container_id, start_datetime_utc, actual_value |
tbl_energy_storage_container_grid_buy_hourly | Bình lưu trữ năng lượng mua điện | energy_storage_container_id, start_datetime_utc, actual_value |
tbl_energy_storage_container_grid_sell_hourly | Bình lưu trữ năng lượng bán điện | energy_storage_container_id, start_datetime_utc, actual_value |
tbl_microgrid_charge_hourly | Dung lượng sạc của lưới vi mô | microgrid_id, start_datetime_utc, actual_value |
tbl_microgrid_discharge_hourly | Dung lượng xả của lưới vi mô | microgrid_id, start_datetime_utc, actual_value |
Thiết kế Chỉ mục:
- Tất cả các bảng đều có chỉ mục kết hợp:
(ID Đối tượng, ID Phân loại, start_datetime_utc)hoặc(ID Đối tượng, start_datetime_utc) - Hỗ trợ truy vấn nhanh theo đối tượng và khoảng thời gian
Lưu ý phát triển:
start_datetime_utcbiểu thị thời gian bắt đầu của khoảng thời gian (ví dụ: 01/01/2024 00:00:00 biểu thị từ 0:00 đến 1:00 ngày 1 tháng 1)actual_valuelà giá trị tổng hợp, không phải giá trị gốc- Dữ liệu được dịch vụ tổng hợp tính toán định kỳ, không được ghi theo thời gian thực
- Lưu ý chuyển đổi múi giờ khi truy vấn
4. myems_billing_db (Cơ sở dữ liệu Thanh toán)
Mục đích: Lưu trữ dữ liệu tiêu thụ năng lượng liên quan đến thanh toán. Cấu trúc của nó tương tự như myems_energy_db, nhưng dữ liệu được tính toán dựa trên giá điện.
Đặc điểm:
- Cấu trúc bảng giống hệt
myems_energy_db - Dữ liệu được dịch vụ
myems-aggregationtính toán bằng cách sử dụng cấu hình giá điện - Hỗ trợ các quy tắc thanh toán phức tạp như giá điện theo giờ sử dụng và giá theo tầng
Bảng chính:
- Cấu trúc bảng giống hệt
myems_energy_db - Giá trị dữ liệu được nhân với giá điện tương ứng, thường bằng đơn vị tiền tệ (ví dụ: CNY, USD)
Lưu ý Phát triển:
- Dữ liệu thanh toán phụ thuộc vào cấu hình giá điện trong
myems_system_db.tbl_tariffs - Phải liên kết với các trung tâm chi phí (
cost_center) - Hỗ trợ nhiều chiến lược giá điện (theo giờ sử dụng, theo tầng, dựa trên dung lượng, v.v.)
5. myems_carbon_db (Cơ sở dữ liệu Phát thải Carbon)
Mục đích: Lưu trữ dữ liệu năng lượng liên quan đến phát thải carbon cho việc tính toán dấu chân carbon.
Đặc điểm:
- Cấu trúc bảng giống hệt
myems_energy_db - Dữ liệu được dịch vụ
myems-aggregationtính toán dựa trên hệ số phát thải carbon - Hệ số phát thải carbon được lưu trữ trong
myems_system_db.tbl_energy_categories.kgco2e
Bảng chính:
- Cấu trúc bảng giống hệt
myems_energy_db - Giá trị dữ liệu được nhân với hệ số phát thải carbon, thường tính bằng kgCO2e (kilogram tương đương CO₂)
Lưu ý Phát triển:
- Hệ số phát thải carbon có thể thay đổi theo thời gian, do đó phải hỗ trợ các hệ số lịch sử
- Các loại năng lượng khác nhau (điện, ga, dầu, v.v.) có các hệ số phát thải khác nhau
- Hỗ trợ tính toán phát thải carbon Phạm vi 1, Phạm vi 2 và Phạm vi 3
6. myems_energy_baseline_db (Cơ sở dữ liệu Đường cơ sở Năng lượng)
Mục đích: Lưu trữ dữ liệu đường cơ sở năng lượng cho phân tích tiết kiệm năng lượng và đánh giá hiệu quả năng lượng.
Đặc điểm:
- Cấu trúc bảng tương tự như
myems_energy_db - Dữ liệu đường cơ sở thường được tính toán dựa trên dữ liệu lịch sử hoặc giá trị tiêu chuẩn
- Được sử dụng để so sánh tiêu thụ năng lượng thực tế với tiêu thụ đường cơ sở để tính toán tiết kiệm năng lượng
Bảng chính:
- Cấu trúc bảng giống hệt
myems_energy_db - Lưu trữ giá trị đường cơ sở thay vì giá trị thực tế
Lưu ý Phát triển:
- Dữ liệu đường cơ sở cần được cập nhật định kỳ
- Hỗ trợ nhiều phương pháp tính toán đường cơ sở (trung bình lịch sử, phân tích hồi quy, giá trị tiêu chuẩn, v.v.)
7. Myems_energy_model_db (cơ sở dữ liệu mô hình tiêu thụ năng lượng)
Mục đích: Lưu trữ dữ liệu mô hình tiêu thụ năng lượng 8760 giờ hàng năm (8760 giờ mỗi năm).
Đặc điểm:
- Mỗi đối tượng lưu trữ 8760 bản ghi (dữ liệu hàng giờ trong một năm)
- Được sử dụng để dự báo và lập kế hoạch tiêu thụ năng lượng
- Tên bảng chứa hậu tố
_8760
Bảng chính:
| tên bảng | Mô tả | trường khóa |
|---|---|---|
tbl_meter_8760 | Mô hình 8760 giờ của đồng hồ đo | meter_id, start_datetime_utc, actual_value |
tbl_equipment_input_category_8760 | Mô hình tiêu thụ năng lượng đầu vào Thiết bị | equipment_id, energy_category_id, start_datetime_utc, actual_value |
tbl_combined_equipment_input_category_8760 | Mô hình tiêu thụ năng lượng đầu vào Thiết bị kết hợp | combined_equipment_id, energy_category_id, start_datetime_utc, actual_value |
tbl_space_input_category_8760 | Mô hình tiêu thụ năng lượng đầu vào Không gian | space_id, energy_category_id, start_datetime_utc, actual_value |
tbl_shopfloor_input_category_8760 | Mô hình tiêu thụ năng lượng đầu vào Xưởng sản xuất | shopfloor_id, energy_category_id, start_datetime_utc, actual_value |
tbl_store_input_category_8760 | Mô hình tiêu thụ năng lượng đầu vào Cửa hàng | store_id, energy_category_id, start_datetime_utc, actual_value |
tbl_tenant_input_category_8760 | Mô hình tiêu thụ năng lượng đầu vào Khách thuê | tenant_id, energy_category_id, start_datetime_utc, actual_value |
Lưu ý phát triển:
- Mô hình 8760 giờ thường được tạo ra dựa trên dữ liệu lịch sử hoặc mô hình tiêu chuẩn
- Được sử dụng để dự báo tiêu thụ năng lượng hàng năm và lập ngân sách
- Hỗ trợ xem theo các chiều như tuần, tháng, quý, v.v.
8. myems_energy_plan_db (Cơ sở dữ liệu Kế hoạch Năng lượng)
Mục đích: Lưu trữ dữ liệu kế hoạch và mục tiêu năng lượng.
Đặc điểm:
- Cấu trúc bảng tương tự như
myems_energy_db - Lưu trữ giá trị kế ho ạch thay vì giá trị thực tế
- Được sử dụng cho lập ngân sách tiêu thụ năng lượng và quản lý mục tiêu
Bảng chính:
- Cấu trúc bảng giống hệt
myems_energy_db - Dữ liệu đến từ các tệp kế hoạch hoặc nhập thủ công
Lưu ý Phát triển:
- Dữ liệu kế hoạch cần được so sánh với dữ liệu thực tế để phân tích
- Hỗ trợ các kế hoạch nhiều cấp (hàng năm, hàng tháng, hàng tuần, v.v.)
9. myems_energy_prediction_db (Cơ sở dữ liệu Dự báo Năng lượng)
Mục đích: Lưu trữ dữ liệu dự báo tiêu thụ năng lượng.
Đặc điểm:
- Cấu trúc bảng tương tự như
myems_energy_db - Lưu trữ giá trị dự báo thay vì giá trị thực tế
- Được sử dụng để dự báo và cảnh báo tiêu thụ năng lượng
Bảng chính:
- Cấu trúc bảng giống hệt
myems_energy_db - Dữ liệu được tạo ra bởi các thuật toán dự báo
Lưu ý Phát triển:
- Dữ liệu dự báo cần được cập nhật định kỳ
- Hỗ trợ nhiều thuật toán dự báo (chuỗi thời gian, học máy, v.v.)
- Độ chính xác dự báo cần được tối ưu hóa liên tục
10. Myems_fdd_db (Cơ sở dữ liệu Chẩn đoán Lỗi)
Mục đích: Lưu trữ dữ liệu liên quan đến phát hiện và chẩn đoán lỗi.
Đặc điểm:
- Hỗ trợ nhiều kênh cảnh báo (web, email, SMS, WeChat, điện thoại)
- Bộ máy quy tắc hỗ trợ logic phát hiện lỗi phức tạp
- Hỗ trợ xác nhận và xử lý thông báo lỗi
Cấu trúc Bảng chính:
| tên bảng | Mô tả | trường khóa |
|---|---|---|
tbl_rules | Quy tắc chẩn đoán | id, name, category, fdd_code, priority, channel, expression (JSON), message_template, is_enabled |
tbl_web_messages | Tin nhắn Web | id, rule_id, user_id, subject, category, priority, message, status, belong_to_object_type, belong_to_object_id |
tbl_email_messages | Tin nhắn Email | id, rule_id, recipient_name, recipient_email, subject, message, attachment_file_name, status |
tbl_text_messages_outbox | Hộp thư đi SMS | id, rule_id, recipient_mobile, message, status, acknowledge_code |
tbl_text_messages_inbox | hộp thư đến sms | id, sender_mobile, message, status |
tbl_wechat_messages_outbox | Hộp thư gửi tin nhắn WeChat | id, rule_id, recipient_openid, message_template_id, message_data (JSON) |
tbl_wechat_messages_inbox | Hộp thư đến tin nhắn WeChat | id, sender_openid, message, status |
tbl_email_servers | Cấu hình Máy chủ Email | id, host, port, requires_authentication, user_name, password, from_addr |
tbl_wechat_configs | Cấu hình WeChat | id, api_server, app_id, app_secret, access_token, expires_datetime_utc |
Phân loại Quy tắc (category):
REALTIME: Cảnh báo thời gian thựcSYSTEM: Cảnh báo hệ thốngSPACE: Cảnh báo Không gianMETER: Cảnh báo Đồng hồ đoTENANT: Cảnh báo Khách thuêSTORE: Cảnh báo Cửa hàngSHOPFLOOR: Cảnh báo Xưởng sản xuấtEQUIPMENT: Cảnh báo Thiết bịCOMBINEDEQUIPMENT: Cảnh báo Thiết bị kết hợp
Mức độ ưu tiên (priority):
CRITICAL: Rất nghiêm trọngHIGH: CaoMEDIUM: Trung bìnhLOW: Thấp
Lưu ý Phát triển:
- Trường
expressionlưu trữ biểu thức quy tắc ở định dạng JSON message_templatehỗ trợ thay thế biến (ví dụ:$name,$value)- Quy tắc hỗ trợ cả thực thi theo lịch trình và thực thi ngay lập tức
- Trạng thái thông báo:
new→sent→acknowledged/timeout
11. myems_user_db (Cơ sở dữ liệu Người dùng)
Mục đích: Lưu trữ xác thực người dùng, khóa API, tin nhắn email, v.v.
Đặc điểm:
- Khối lượng dữ liệu nhỏ, nhưng yêu cầu bảo mật cao
- Hỗ trợ quản lý quyền người dùng
- Hỗ trợ xác thực khóa API
Cấu trúc Bảng chính:
| tên bảng | Mô tả | trường khóa |
|---|---|---|
tbl_users | Thông tin Người dùng | 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 | Cấu hình Quyền hạn | id, name, data (định dạng JSON) |
tbl_sessions | phiên người dùng | id, user_uuid, token, utc_expires |
tbl_api_keys | Khóa API | id, name, token, created_datetime_utc, expires_datetime_utc |
tbl_email_messages | Tin nhắn Email | id, recipient_name, recipient_email, subject, message, attachment_file_name, status, scheduled_datetime_utc |
tbl_email_message_sessions | Cuộc hội thoại Email | id, recipient_email, token, expires_datetime_utc |
tbl_logs | Nhật ký hoạt động | id, user_uuid, request_datetime_utc, request_method, resource_type, resource_id, request_body (JSON) |
tbl_notifications | Tin nhắn Thông báo | id, user_id, created_datetime_utc, status, subject, message, url |
tbl_new_users | Người dùng mới (chờ kích hoạt) | id, name, uuid, display_name, email, salt, password |
tbl_verification_codes | Mã Xác minh | id, recipient_email, verification_code, created_datetime_utc, expires_datetime_utc |
Thiết kế Bảo mật:
- Mật khẩu được lưu trữ bằng cách sử dụng muối + băm, không lưu trữ dạng văn bản thuần
- Hỗ trợ thời gian hết hạn tài khoản và mật khẩu
- Hỗ trợ giới hạn số lần thử đăng nhập thất bại
- Khóa API hỗ trợ thời gian hết hạn
Lưu ý Phát triển:
- Trường mật khẩu nên được mã hóa để lưu trữ, không truy vấn trực tiếp
- Token phiên nên được dọn dẹp định kỳ để xóa các bản ghi hết hạn
- Nhật ký hoạt động nên ghi lại tất cả các hành động quan trọng cho việc kiểm toán
- Trạng thái thông báo:
unread→read→archived
12. myems_reporting_db (Cơ sở dữ liệu Báo cáo)
Mục đích: Lưu trữ tin nhắn email và tệp đính kèm liên quan đến báo cáo.
Đặc điểm:
- Khối lượng dữ liệu nhỏ
- Hỗ trợ lưu trữ mẫu báo cáo và các tệp đã tạo
Cấu trúc Bảng chính:
| tên bảng | Mô tả | trường khóa |
|---|---|---|
tbl_reports | Cấu hình Báo cáo | id, name, uuid, expression (JSON), is_enabled, last_run_datetime_utc, next_run_datetime_utc, is_run_immediately |
tbl_reports_files | tài liệu báo cáo | id, uuid, create_datetime_utc, file_name, file_type (xlsx/pdf/docx), file_object (LONGBLOB) |
tbl_template_files | Tệp Mẫu Báo cáo | id, uuid, report_id, file_name, file_type, file_object |
tbl_email_messages | Tin nhắn Email | id, recipient_name, recipient_email, subject, message, attachment_file_name, attachment_file_object, status |
Lưu ý Phát triển:
- Tệp báo cáo hỗ trợ các định dạng Excel, PDF và Word
- Tệp mẫu được sử dụng để tạo báo cáo
- Báo cáo hỗ trợ cả tạo theo lịch trình và tạo ngay lập tức
- Tệp được lưu trữ bằng
LONGBLOB; lưu ý giới hạn kích thước
13. myems_production_db (Cơ sở dữ liệu Sản xuất)
Mục đích: Lưu trữ dữ liệu sản phẩm liên quan đến sản xuất.
Đặc điểm:
- Khối lượng dữ liệu nhỏ
- Được sử dụng cho phân tích tương quan tiêu thụ năng lượng sản xuất
Cấu trúc Bảng chính:
| tên bảng | Mô tả | trường khóa |
|---|---|---|
tbl_products | Thông tin Sản phẩm | id, name, uuid, unit_of_measure, tag, standard_product_coefficient |
tbl_teams | Thông tin Đội nhóm | id, name, uuid, description |
tbl_shifts | thông tin ca làm việc | id, shopfloor_id, team_id, product_id, product_count, start_datetime_utc, end_datetime_utc, reference_timestamp |
tbl_shopfloor_hourly | Lượng sản xuất hàng giờ của Xưởng sản xuất | id, shopfloor_id, start_datetime_utc, product_id, product_count |
tbl_space_hourly | Lượng sản xuất hàng giờ của Không gian | id, space_id, start_datetime_utc, product_id, product_count |
tbl_shopfloors_products | Liên kết Xưởng sản xuất và sản phẩm | id, shopfloor_id, product_id |
tbl_shopfloors_teams | Liên kết Xưởng sản xuất và đội nhóm | id, shopfloor_id, team_id |
Lưu ý phát triển:
- Dữ liệu sản xuất được sử dụng để tính toán tiêu thụ năng lượng đơn vị sản phẩm
- Hỗ trợ thống kê dựa trên các chiều như sản phẩm, đội nhóm, xưởng sản xuất, v.v.
- Liên kết với dữ liệu tiêu thụ năng lượng để tính toán các chỉ số hiệu quả năng lượng
Mối quan hệ luồng dữ liệu
Quy trình thu thập dữ liệu
Luồng Thu thập Dữ liệu
Thiết bị / Cảm biến
↓ (Modbus TCP / MQTT / HTTP)
myems-modbus-tcp (Dịch vụ Thu thập Dữ liệu)
↓ (Ghi)
myems_historical_db.tbl_analog_value / tbl_digital_value / tbl_energy_value
↓ (Chuẩn hóa Dữ liệu)
myems-normalization (Dịch vụ Chuẩn hóa)
↓ (Dọn dẹp Dữ liệu)
myems-cleaning (Dịch vụ Dọn dẹp)
↓ (Tổng hợp Dữ liệu)
myems-aggregation (Dịch vụ Tổng hợp)
↓ (Ghi)
myems_energy_db (Dữ liệu Năng lượng)
myems_billing_db (Dữ liệu Thanh toán)
myems_carbon_db (Dữ liệu Phát thải Carbon)
Luồng Truy vấn Dữ liệu
Yêu cầu Người dùng
↓
myems-api (Dịch vụ API)
↓ (Truy vấn)
myems_system_db (Dữ liệu Cấu hình)
myems_historical_db (Dữ liệu Lịch sử)
myems_energy_db (Dữ liệu Năng lượng)
↓ (Phản hồi)
myems-web / myems-admin (Hiển thị Frontend)
Sơ đồ Mối quan hệ Dữ liệu
myems_system_db.tbl_points
↓ (point_id)
myems_historical_db.tbl_analog_value
↓ (Tính toán Tổng hợp)
myems_energy_db.tbl_meter_hourly
↓ (Liên kết)
myems_system_db.tbl_meters
↓ (Liên kết)
myems_system_db.tbl_equipments
↓ (Liên kết)
myems_system_db.tbl_spaces
Quy tắc Thiết kế Cấu trúc Bảng
Trường chung
Tất cả các bảng đều chứa các trường chung sau:
| tên trường | kiểu | Mô tả |
|---|---|---|
id | BIGINT NOT NULL AUTO_INCREMENT | Khóa chính, tự tăng |
name | VARCHAR(255) | tên |
uuid | CHAR(36) | UUID， Được sử dụng cho tích hợp hệ thống bên ngoài |
description | VARCHAR(255) | Mô tả (tùy chọn) |
Trường thời gian
| tên trường | kiểu | Mô tả |
|---|---|---|
utc_date_time | DATETIME | Thời gian UTC (bảng dữ liệu lịch sử) |
start_datetime_utc | DATETIME | Thời gian bắt đầu của khoảng thời gian (bảng dữ liệu tổng hợp) |
created_datetime_utc | DATETIME | Thời gian Tạo |
updated_datetime_utc | DATETIME | Thời gian Cập nhật |
last_run_datetime_utc | DATETIME | Thời gian Chạy lần cuối |
next_run_datetime_utc | DATETIME | Thời gian Chạy tiếp theo |
Lưu ý: Tất cả các trường thời gian nên sử dụng thời gian UTC một cách thống nhất, và hiển thị phía frontend nên được chuyển đổi sang thời gian địa phương.
Trường số
| tên trường | kiểu | Mô tả |
|---|---|---|
actual_value | DECIMAL(21, 6) | Giá trị thực tế, hỗ trợ độ chính xác cao (6 chữ số thập phân) |
set_value | DECIMAL(21, 6) | giá trị đặt |
rated_capacity | DECIMAL(21, 6) | Dung lượng định mức |
rated_power | DECIMAL(21, 6) | công suất định mức |
Trường JSON
| tên trường | kiểu | Mô tả |
|---|---|---|
connection | LONGTEXT | Cấu hình Kết nối (định dạng JSON) |
expression | LONGTEXT | Biểu thức (định dạng JSON) |
payload | LONGTEXT | Tải (định dạng JSON) |
data | LONGTEXT | Dữ liệu (định dạng JSON) |
Lưu ý: Trường JSON lưu trữ chuỗi JSON định d ạng và cần được phân tích trước khi sử dụng.
Trường trạng thái
| tên trường | kiểu | Mô tả |
|---|---|---|
is_enabled | BOOL | Bật hay không |
is_active | BOOL | Trạng thái kích hoạt |
is_bad | BOOL | Có dữ liệu lỗi không |
is_published | BOOL | Đã được phát hành chưa? |
is_counted | BOOL | Có được tính vào thống kê không |
status | VARCHAR(32) | Trạng thái (ví dụ: new, sent, done, error) |
Thiết kế Chỉ mục
Chỉ mục khóa chính:
- Tất cả các bảng đều có
PRIMARY KEY (id)
Chỉ mục duy nhất:
- Các trường khóa (như
name,uuid) thường có các chỉ mục duy nhất
Chỉ mục kết hợp:
- Thiết lập chỉ mục kết hợp cho các tổ hợp trường được truy vấn thường xuyên
- Ví dụ:
(point_id, utc_date_time),(meter_id, start_datetime_utc)
Chỉ mục thời gian:
- Trường thời gian thường được lập chỉ mục riêng và hỗ trợ truy vấn khoảng thời gian