เอกสารออกแบบฐานข้อมูล MyEMS
เอกสารนี้จัดทำขึ้นสำหรับโปรแกรมเมอร์ อธิบายรายละเอียดสถาปัตยกรรมฐานข้อมูล โครงสร้างตาราง และแนวคิดการออกแบบของระบบบริหารจัดการพลังงาน MyEMS
การออกแบบสถาปัตยกรรมฐานข้อมูล
แนวคิดการออกแบบ
- แยกข้อมูล: แยกข้อมูลออกเป็นฐานข้อมูลต่าง ๆ ตามประเภทและการใช้งาน เพื่อป้องกันฐานข้อมูลเดียวมีขนาดใหญ่เกินไป
- แยกอ่าน-เขียน: ข้อมูลประวัติจะถูกจัดเก็บในรูปแบบ time series เพื่อให้สามารถค้นหาได้อย่างมีประสิทธิภาพ
- ขยายแนวนอน: ฐานข้อมูลขนาดใหญ่ (historical_db, energy_db) สามารถขยายได้อย่างอิสระ
- มาตรฐานเดียวกัน: ฐานข้อมูลทั้งหมดใช้ชุดอักขระและกฎการเรียงลำดับเดียวกัน
การตั้งค่าฐานข้อมูล
ฐานข้อมูลทั้งหมดใช้การตั้งค่าดังนี้:
- ชุดอักขระ:
utf8mb4(รองรับ UTF-8 ครบถ้วน รวม emoji) - กฎการเรียงลำดับ:
utf8mb4_unicode_ci(กฎ Unicode) - Storage engine: InnoDB (ค่าเริ่มต้น รองรับธุรกรรมและ foreign key)
กฎการตั้งชื่อ
- ชื่อฐานข้อมูล:
myems_{Function}_d_db(ตัวพิมพ์เล็ก คั่นด้วยขีดล่าง) - ชื่อตาราง:
tbl_{Entity Name}(ตัวพิมพ์เล็ก คั่นด้วยขีดล่าง) - ชื่อฟิลด์: ตัวพิมพ์เล็ก คั่นด้วยขีดล่าง เช่น
start_datetime_utc - ชื่อดัชนี:
tbl_{Table Name}_index_{Sequence Number}
รายละเอียดฐานข้อมูล
1. Myems_system_deb (ฐานข้อมูลการตั้งค่าระบบ)
วัตถุประสงค์: เก็บข้อมูลการตั้งค่าและเมตาดาต้าพื้นฐานของระบบ เป็นฐานข้อมูลแกนกลางของระบบทั้งหมด
คุณสมบัติ:
- มีจำนวนตารางมากที่สุด (ประมาณ 150+ ตาราง)
- ปริมาณข้อมูลไม่มาก แต่โครงสร้างซับซ้อน
- มีตารางความสัมพันธ์จำนวนมาก
การแบ่งกลุ่มตารางหลัก:
1.1 ตารางการตั้งค่าพื้นฐาน
| table name | Instructions | key field |
|---|---|---|
tbl_energy_categories | Energy classification (electricity, water, gas, cold, heat, etc.) | id, name, unit_of_measure, kgce, kgco2e |
tbl_energy_items | Energy consumption sub items (lighting, air conditioning, power, etc.) | id, name, energy_category_id |
tbl_cost_centers | cost center | id, name, external_id |
tbl_data_sources | Data Source Configuration | id, name, gateway_id, protocol, connection |
tbl_protocols | Protocol Configuration | id, name, protocol_type |
1.2 ตารางจัดการอุปกรณ์
| table name | Instructions | key field |
|---|---|---|
tbl_equipments | Device Information | id, name, uuid, equipment_type_id, cost_center_id |
tbl_combined_equipments | Combination device (combination of multiple devices) | id, name, is_input_counted, is_output_counted |
tbl_meters | Meter information | id, name, uuid, energy_category_id, is_counted |
tbl_offline_meters | Offline meter (manually entered) | id, name, energy_category_id |
tbl_virtual_meters | Virtual Meter (Calculated) | Id, name, expression (in JSON format) |
tbl_points | Data point information | id, name, data_source_id, object_type, object_id |
1.3 ตารางการจัดระเบียบพื้นที่
| table name | Instructions | key field |
|---|---|---|
tbl_spaces | Spatial information (rooms, floors, etc.) | id, name, uuid, parent_space_id, area |
tbl_stores | Store Information | id, name, uuid, space_id |
tbl_tenants | tenant information | id, name, uuid, space_id |
tbl_shopfloors | Workshop information | id, name, uuid, space_id |
1.4 ตารางความสัมพันธ์
ระบบใช้ตารางความสัมพันธ์จำนวนมากเพื่อสร้างความสัมพันธ์แบบ many-to-many:
tbl_equipments_meters: Association between equipment and meterstbl_equipments_offline_meters: Association between equipment and offline meterstbl_equipments_virtual_meters: Association between equipment and virtual meterstbl_spaces_equipments: The association between space and equipmenttbl_spaces_meters: The association between space and meterstbl_combined_equipments_equipments: Association between combined equipment and devices- etc...
1.5 รายการอุปกรณ์พลังงานใหม่
| table name | Instructions | key field |
|---|---|---|
tbl_photovoltaic_power_stations | photovoltaic power station | id, name, capacity, contact_id |
tbl_energy_storage_containers | Energy storage container | id, name, rated_capacity, rated_power |
tbl_energy_storage_power_stations | energy storage power station | id, name, rated_capacity |
tbl_microgrids | microgrid | id, name, address |
tbl_charging_stations | charging station | id, name, rated_capacity, rated_power |
1.6 ตารางควบคุมและตารางกำหนดเวลา
| table name | Instructions | key field |
|---|---|---|
tbl_commands | control command | Id, name, topic, payload (in JSON format) |
tbl_control_modes | control mode | id, name, is_active |
tbl_control_modes_times | Control mode time period | id, control_mode_id, start_time_of_day, end_time_of_day |
1.7 ตารางการตั้งค่าอื่น ๆ
tbl_contacts: Contact informationtbl_distribution_systems: Distribution systemstbl_distribution_circuits: Distribution circuitstbl_energy_flow_diagrams: Energy Flow Diagramtbl_tariffs: Electricity pricing configurationtbl_working_calendars: Work calendarstbl_web_messages: Web Messages
ข้อควรระวังในการพัฒนา:
- ทุกตารางมี 'id' (BIGINT AUTO-INCREMENT) เป็น primary key
- ตารางส่วนใหญ่มีฟิลด์ 'uuid' (CHAR(36)) สำหรับเชื่อมต่อกับระบบภายนอก
- ตารางความสัมพันธ์มักมีแค่ 'id' และ foreign key สองตัว
- ฟิลด์ JSON ใช้ชนิด 'LONGTEXT' ในการเก็บข้อมูล JSON
2. Myems_historics_db (ฐานข้อมูลข้อมูลประวัติ)
วัตถุประสงค์: เก็บข้อมูลมอนิเตอร์แบบเรียลไทม์และข้อมูลประวัติ เป็นฐานข้อมูลที่มีปริมาณข้อมูลมากที่สุดในระบบ
คุณสมบัติ:
- ปริมาณข้อมูลมหาศาล ใช้การจัดเก็บแบบ time series
- มีทั้งข้อมูลดิบและตารางแคชค่าล่าสุด
- รองรับการติดป้ายคุณภาพข้อมูล (
is_bad,is_published)
โครงสร้างตารางหลัก:
| table name | Instructions | key field | Index strategy |
|---|---|---|---|
tbl_analog_value | Analog historical data | point_id, utc_date_time, actual_value, is_bad, is_published | (point_id, utc_date_time), (utc_date_time) |
tbl_analog_value_latest | Latest analog value (cache) | point_id, utc_date_time, actual_value | (point_id, utc_date_time) |
tbl_digital_value | Digital historical data | point_id, utc_date_time, actual_value (INT) | (point_id, utc_date_time), (utc_date_time) |
tbl_digital_value_latest | Latest numerical value (cache) | point_id, utc_date_time, actual_value | (point_id, utc_date_time) |
tbl_energy_value | Historical energy consumption data | point_id, utc_date_time, actual_value, is_bad, is_published | (point_id, utc_date_time), (utc_date_time) |
tbl_energy_value_latest | Latest energy consumption value (cache) | point_id, utc_date_time, actual_value | (point_id, utc_date_time) |
tbl_text_value | Text volume historical data | point_id, utc_date_time, actual_value (LONGTEXT) | (point_id, utc_date_time), (utc_date_time) |
tbl_text_value_latest | Latest text volume value (cache) | point_id, utc_date_time, actual_value | (point_id, utc_date_time) |
ตารางเก็บไฟล์:
| table name | Instructions | key field |
|---|---|---|
tbl_cost_files | Cost document (Excel/CSV) | file_name, uuid, upload_datetime_utc, status, file_object (LONGBLOB) |
tbl_offline_meter_files | Offline meter data file | file_name, uuid, upload_datetime_utc, status, file_object |
tbl_data_repair_files | Data repair file | file_name, uuid, upload_datetime_utc, status, file_object |
tbl_energy_plan_files | Energy consumption plan document | file_name, uuid, upload_datetime_utc, status, file_object |
คำอธิบายชนิดข้อมูล:
practice_value: DECIMAL (21,6) - รองรับค่าตัวเลขความละเอียดสูง 6 ตำแหน่งทศนิยมutc_date_time: DATETIME - เวลา UTC ทุกฟิลด์เวลาใช้ UTCis_bad: BOOL - ป้ายคุณภาพข้อมูล True คือข้อมูลเสียis_published: BOOL - ป้ายเผยแพร่ True คือเผยแพร่แล้ว
ข้อควรระวังในการพัฒนา:
- ฟิลด์เวลาทั้งหมดใช้ UTC และแสดงผลที่หน้าบ้านเป็นเวลาท้องถิ่น
- ตาราง
_latestใช้สำหรับค้นหาค่าล่าสุดอย่างรวดเร็ว - ตารางไฟล์ใช้
LONGBLOBเก็บไฟล์ไบนารี ต้องระวังขนาดไฟล์ - ควรลบข้อมูลประวัติเป็นประจำเพื่อป้องกันตารางใหญ่เกินไป
3. Myems_energy_db (ฐานข้อมูลการใช้พลังงาน)
วัตถุประสงค์: เก็บสถิติการใช้พลังงานของอุปกรณ์ต่าง ๆ และรวมผลตามชั่วโมง วัน เดือน ปี
คุณสมบัติ:
- ข้อมูลถูกคำนวณและสร้างโดยบริการ
myems-aggregation - แบ่งตามช่วงเวลาเป็นตารางรายชั่วโมง รายวัน รายเดือน รายปี
- รองรับสถิติตามหมวดพลังงานและรายการใช้พลังงาน
กฎการตั้งชื่อตาราง:
tbl_{Object Type}_{Direction}_{Classification}_{Time Granularity}- ประเภทของวัตถุ:
meter,equipment,combined_equipment,space,store,tenant,shopfloor - ทิศทาง:
input(ขาเข้า),output(ขาออก) - หมวดหมู่:
category(หมวดพลังงาน),item(รายการใช้พลังงาน) - ช่วงเวลา:
hourly,daily,monthly,yearly
โครงสร้างตารางหลัก:
3.1 Energy consumption meter
| table name | Instructions | key field |
|---|---|---|
tbl_meter_hourly | Hourly energy consumption of the meter | meter_id, start_datetime_utc, actual_value |
tbl_meter_daily | Daily energy consumption of the meter | meter_id, start_datetime_utc, actual_value |
tbl_meter_monthly | Monthly energy consumption of the meter | meter_id, start_datetime_utc, actual_value |
tbl_meter_yearly | Annual energy consumption of the meter | meter_id, start_datetime_utc, actual_value |
tbl_offline_meter_hourly | Offline meter hourly energy consumption | offline_meter_id, start_datetime_utc, actual_value |
tbl_virtual_meter_hourly | Virtual meter hourly energy consumption | virtual_meter_id, start_datetime_utc, actual_value |
3.2 Equipment Energy Consumption Table
| table name | Instructions | key field |
|---|---|---|
tbl_equipment_input_category_hourly | Equipment input energy consumption (by category) | equipment_id, energy_category_id, start_datetime_utc, actual_value |
tbl_equipment_input_item_hourly | Equipment input energy consumption (by item) | equipment_id, energy_item_id, start_datetime_utc, actual_value |
tbl_equipment_output_category_hourly | Equipment output energy consumption (by category) | equipment_id, energy_category_id, start_datetime_utc, actual_value |
tbl_combined_equipment_input_category_hourly | Combination device input energy consumption (by category) | combined_equipment_id, energy_category_id, start_datetime_utc, actual_value |
tbl_combined_equipment_output_category_hourly | Energy consumption of combined equipment output (by classification) | combined_equipment_id, energy_category_id, start_datetime_utc, actual_value |
3.3 Space Energy Consumption Table
| table name | Instructions | key field |
|---|---|---|
tbl_space_input_category_hourly | Space input energy consumption (by category) | space_id, energy_category_id, start_datetime_utc, actual_value |
tbl_space_input_item_hourly | Space input energy consumption (by item) | space_id, energy_item_id, start_datetime_utc, actual_value |
tbl_space_output_category_hourly | Space output energy consumption (by classification) | space_id, energy_category_id, start_datetime_utc, actual_value |
tbl_store_input_category_hourly | Store input energy consumption | store_id, energy_category_id, start_datetime_utc, actual_value |
tbl_tenant_input_category_hourly | Tenant inputs energy consumption | tenant_id, energy_category_id, start_datetime_utc, actual_value |
tbl_shopfloor_input_category_hourly | Workshop input energy consumption | shopfloor_id, energy_category_id, start_datetime_utc, actual_value |
3.4 Energy Consumption Table of New Energy Equipment
| table name | Instructions | key field |
|---|---|---|
tbl_photovoltaic_power_station_hourly | Hourly power generation of photovoltaic power station | photovoltaic_power_station_id, start_datetime_utc, actual_value |
tbl_energy_storage_container_charge_hourly | Charging capacity of energy storage container | energy_storage_container_id, start_datetime_utc, actual_value |
tbl_energy_storage_container_discharge_hourly | Discharge capacity of energy storage container | energy_storage_container_id, start_datetime_utc, actual_value |
tbl_energy_storage_container_grid_buy_hourly | Energy storage container purchases electricity | energy_storage_container_id, start_datetime_utc, actual_value |
tbl_energy_storage_container_grid_sell_hourly | Electricity sales from energy storage containers | energy_storage_container_id, start_datetime_utc, actual_value |
tbl_microgrid_charge_hourly | Microgrid charging capacity | microgrid_id, start_datetime_utc, actual_value |
tbl_microgrid_discharge_hourly | Microgrid discharge capacity | microgrid_id, start_datetime_utc, actual_value |
การออกแบบดัชนี:
- ทุกตารางมีดัชนีผสม:
(Object ID, Classification ID, start_datetime_utc)หรือ(Object ID, start_datetime_utc) - รองรับการค้นหาความเร็วตามวัตถุและช่วงเวลา
ข้อควรระวังในการพัฒนา:
start_datetime_utcคือเวลาเริ่มต้นของช่วงเวลา (เช่น 2024-01-01 00:00:00 คือ 1 ม.ค. 0:00-1:00)actual_valueคือค่ารวม ไม่ใช่ค่าดิบ- ข้อมูลถูกคำนวณเป็นระยะ ๆ โดยบริการ aggregation ไม่ได้เขียนแบบเรียลไทม์
- ต้องระวังการแปลงเขตเวลาเมื่อค้นหา
4. myems_billing_db (ฐานข้อมูลการคิดเงิน)
วัตถุประสงค์: เก็บข้อมูลการใช้พลังงานที่เกี่ยวข้องกับการคิดเงิน โครงสร้างคล้าย myems_energy_db แต่ข้อมูลคำนวณตามอัตราค่าไฟ
คุณสมบัติ:
- โครงสร้างตารางเหมือน
myems_energy_db - ข้อมูลคำนวณโดย
myems-aggregationตามการตั้งค่าอัตราค่าไฟ - รองรับกฎการคิดเงินที่ซ ับซ้อน เช่น อัตราตามช่วงเวลา อัตราขั้นบันได
ตารางหลัก:
- โครงสร้างตารางเหมือน
myems_energy_db - ค่าข้อมูลคูณด้วยอัตราค่าไฟที่เกี่ยวข้อง หน่วยเป็นสกุลเงิน (เช่น CNY, USD)
หมายเหตุสำหรับการพัฒนา:
- ข้อมูลคิดเงินขึ้นกับการตั้งค่าอัตราใน
myems_system_db.tbl_tariffs - ต้องเชื่อมโยงกับ cost center (
cost_center) - รองรับกลยุทธ์อัตราหลายแบบ (ตามช่วงเวลา, ขั้นบันได, ตามกำลัง ฯลฯ)
5. myems_carbon_db (ฐานข้อมูลคาร์บอน)
วัตถุประสงค์: เก็บข้อมูลพลังงานที่เกี่ยวข้องกับการปล่อยคาร์บอนสำหรับคำนวณคาร์บอนฟุตพริ้นท์
คุณสมบัติ:
- โครงสร้างตารางเห มือน
myems_energy_db - ข้อมูลคำนวณโดย
myems-aggregationตามค่าสัมประสิทธิ์การปล่อยคาร์บอน - ค่าสัมประสิทธิ์การปล่อยคาร์บอนเก็บใน
myems_system_db.tbl_energy_categories.kgco2e
ตารางหลัก:
- โครงสร้างตารางเหมือน
myems_energy_db - ค่าข้อมูลคูณด้วยค่าสัมประสิทธิ์คาร์บอน หน่วยเป็น kgCO2e (กิโลกรัม CO₂ เทียบเท่า)
หมายเหตุสำหรับการพัฒนา:
- ค่าสัมประสิทธิ์คาร์บอนอาจเปลี่ยนแปลงตามเวลา ต้องรองรับประวัติ
- พลังงานแต่ละประเภท (ไฟฟ้า, ก๊าซ, น้ำมัน ฯลฯ) มีค่าสัมประสิทธิ์ต่างกัน
- รองรับการคำนวณคาร์บอน Scope 1, 2, 3
6. myems_energy_baseline_db (ฐานข้อมูลเส้นฐานพลังงาน)
วัตถุประสงค์: เก็บข้อมูลเส้นฐานพลังงานสำหรับวิเคราะห์การประหยัดและประเมินประสิทธิภาพ
คุณสมบัติ:
- โครงสร้างตารางคล้าย
myems_energy_db - ข้อมูลเส้นฐานคำนวณจากข้อมูลประวัติหรือค่ามาตรฐาน
- ใช้เปรียบเทียบกับการใช้จริงเพื่อคำนวณการประหยัด
ตารางหลัก:
- โครงสร้างตารางเหมือน
myems_energy_db - เก็บค่าเส้นฐานแทนค่าจริง
หมายเหตุสำหรับการพัฒนา:
- ข้อมูลเส้นฐานต้องอัปเดตเป็นประจำ
- รองรับหลายวิธีการคำนวณ (ค่าเฉลี่ยประวัติ, การวิเคราะห์ถดถอย, ค่ามาตรฐาน ฯลฯ)
7. Myems_energy_model_deb (ฐานข้อมูลโมเดลการใช้พลังงาน)
วัตถุประสงค์: เก็บข้อมูลโมเดลการใช้พลังงาน 8760 ชั่วโมงต่อปี
คุณสมบัติ:
- แต่ละวัตถุเก็บ 8760 แถว (ข้อมูลรายชั่วโมง 1 ปี)
- ใช้สำหรับพยากรณ์และวางแผนการใช้พลังงาน
- ชื่อตารางลงท้ายด้วย
_8760
ตารางหลัก:
| table name | Instructions | key field |
|---|---|---|
tbl_meter_8760 | Meter 8760 hour model | meter_id, start_datetime_utc, actual_value |
tbl_equipment_input_category_8760 | Equipment input energy consumption model | equipment_id, energy_category_id, start_datetime_utc, actual_value |
tbl_combined_equipment_input_category_8760 | Combination device input energy consumption model | combined_equipment_id, energy_category_id, start_datetime_utc, actual_value |
tbl_space_input_category_8760 | Space input energy consumption model | space_id, energy_category_id, start_datetime_utc, actual_value |
tbl_shopfloor_input_category_8760 | Workshop input energy consumption model | shopfloor_id, energy_category_id, start_datetime_utc, actual_value |
tbl_store_input_category_8760 | Store input energy consumption model | store_id, energy_category_id, start_datetime_utc, actual_value |
tbl_tenant_input_category_8760 | Tenant input energy consumption model | tenant_id, energy_category_id, start_datetime_utc, actual_value |
ข้อควรระวังในการพัฒนา:
- โมเดล 8760 ชั่วโมงมักสร้างจากข้อมูลประวัติหรือโมเดลมาตรฐาน
- ใช้สำหรับพยากรณ์และจัดทำงบประมาณรายปี
- รองรับการดูตามมิติ สัปดาห์ เดือน ไตรมาส ฯลฯ
8. myems_energy_plan_db (ฐานข้อมูลแผนพลังงาน)
วัตถุประสงค์: เก็บข้อมูลแผนและเป้าหมายการใช้พลังงาน
คุณสมบัติ:
- โครงสร้างตารางคล้าย
myems_energy_db - เก็บค่าแผนแทนค่าจริง
- ใช้สำหรับจัดทำงบประมาณและบริหารเป้าหมาย
ตารางหลัก:
- โครงสร้างตารางเหมือน
myems_energy_db - ข้อมูลมาจากไฟล์แผนหรือกรอกด้วยมือ
หมายเหตุสำหรับการพัฒนา:
- ข้อมูลแผนต้องเปรียบเทียบกับข้อมูลจริงเพื่อวิเคราะห์
- รองรับแผนหลายระดับ (รายปี รายเดือน รายสัปดาห์ ฯลฯ)
9. myems_energy_prediction_db (ฐานข้อมูลการพยากรณ์พลังงาน)
วัตถุประสงค์: เก็บข้อมูลการพยากรณ์การใช้พลังงาน
คุณสมบัติ:
- โครงสร้างตา รางคล้าย
myems_energy_db - เก็บค่าพยากรณ์แทนค่าจริง
- ใช้สำหรับพยากรณ์และแจ้งเตือนการใช้พลังงาน
ตารางหลัก:
- โครงสร้างตารางเหมือน
myems_energy_db - ข้อมูลสร้างโดยอัลกอริทึมพยากรณ์
หมายเหตุสำหรับการพัฒนา:
- ข้อมูลพยากรณ์ต้องอัปเดตเป็นประจำ
- รองรับอัลกอริทึมพยากรณ์หลายแบบ (time series, machine learning ฯลฯ)
- ความแม่นยำต้องปรับปรุงอย่างต่อเนื่อง
10. Myems_fdd_db (ฐานข้อมูลวินิจฉัยความผิดปกติ)
วัตถุประสงค์: เก็บข้อมูลที่เกี่ยวข้องกับการตรวจจับและวินิจฉัยความผิดปกติ
คุณสมบัติ:
- รองรับช่องทางแจ้งเตือนหลายแบบ (web, email, SMS, WeChat, โทรศัพท์)
- rule engine รองรับตรรกะการตรวจจับความผิดปกติที่ซับซ้อน
- รองรับการยืนยันและจัดการข้อความแจ้งเตือน
โครงสร้างตารางหลัก:
| table name | Instructions | key field |
|---|---|---|
tbl_rules | Diagnostic rules | id, name, category, fdd_code, priority, channel, expression (JSON), message_template, is_enabled |
tbl_web_messages | Web Message | id, rule_id, user_id, subject, category, priority, message, status, belong_to_object_type, belong_to_object_id |
tbl_email_messages | Email message | id, rule_id, recipient_name, recipient_email, subject, message, attachment_file_name, status |
tbl_text_messages_outbox | SMS inbox | id, rule_id, recipient_mobile, message, status, acknowledge_code |
tbl_text_messages_inbox | sms inbox | id, sender_mobile, message, status |
tbl_wechat_messages_outbox | WeChat message sender box | id, rule_id, recipient_openid, message_template_id, message_data (JSON) |
tbl_wechat_messages_inbox | WeChat message inbox | id, sender_openid, message, status |
tbl_email_servers | Email Server Configuration | id, host, port, requires_authentication, user_name, password, from_addr |
tbl_wechat_configs | WeChat configuration | id, api_server, app_id, app_secret, access_token, expires_datetime_utc |
หมวดหมู่กฎ (category):
REALTIME: แจ้งเตือนเรียลไทม์SYSTEM: แจ้งเตือนระบบSPACE: แจ้งเตือนพื้นที่METER: แจ้งเตือนมิเตอร์TENANT: แจ้งเตือนผู้เช่าSTORE: แจ้งเตือนร้านค้าSHOPFLOOR: แจ้งเตือนโรงงานEQUIPMENT: แจ้งเตือนอุปกรณ์COMBINEDEQUIPMENT: แจ้งเตือนอุปกรณ์รวม
ระดับความสำคัญ (priority):
CRITICAL: วิกฤตHIGH: สูงMEDIUM: กลางLOW: ต่ำ
หมายเหตุสำหรับการพัฒนา:
- ฟิลด์
expressionเก็บนิพจน์กฎในรูปแบบ JSON message_templateรองรับการแทนค่าตัวแปร (เช่น$name,$value)- กฎรองรับทั้งการรันตามเวลาและรันทันที
- สถานะข้อความ:
new→sent→acknowledged/timeout
11. myems_user_db (ฐานข้อมูลผู้ใช้)
วัตถุประสงค์: เก็บข้อมูลยืนยันตัวตนผู้ใช้, API key, อีเมล ฯลฯ
คุณสมบัติ:
- ปริมาณข้อมูลน้อย แต่ต้องการความปลอดภัยสูง
- รองรับการจัดการสิทธิ์ผู้ใช้
- รองรับการยืนยันตัวตนด้วย API key
โครงสร้างตารางหลัก:
| table name | Instructions | key field |
|---|---|---|
tbl_users | User information | 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 | Permission Configuration | Id, name, data (in JSON format) |
tbl_sessions | user session | id, user_uuid, token, utc_expires |
tbl_api_keys | API Key | id, name, token, created_datetime_utc, expires_datetime_utc |
tbl_email_messages | Email message | id, recipient_name, recipient_email, subject, message, attachment_file_name, status, scheduled_datetime_utc |
tbl_email_message_sessions | Email conversation | id, recipient_email, token, expires_datetime_utc |
tbl_logs | Operation log | id, user_uuid, request_datetime_utc, request_method, resource_type, resource_id, request_body (JSON) |
tbl_notifications | Notification message | id, user_id, created_datetime_utc, status, subject, message, url |
tbl_new_users | New user (to be activated) | id, name, uuid, display_name, email, salt, password |
tbl_verification_codes | CAPTCHA | id, recipient_email, verification_code, created_datetime_utc, expires_datetime_utc |
การออกแบบความปลอดภัย:
- รหัสผ่านเก็บแบบ salt+hash ไม่มี plain text
- รองรับวันหมดอายุบัญชีและรหัสผ่าน
- จำกัดจำนวนครั้งที่เข้าสู่ระบบผิดพลาด
- API key รองรับวันหมดอายุ
หมายเหตุสำหรับการพัฒนา:
- ฟิลด์รหัสผ่านต้องเข้ารหัสก่อนเก็บ ห้าม query ตรง
- ควรลบ session token ที่หมดอายุเป็นระยะ
- log การดำเนินการควรบันทึกทุกการกระทำสำคัญเพื่อการตรวจสอบ
- สถานะแจ้งเตือน:
unread→read→archived
12. myems_reporting_db (ฐานข้อมูลรายงาน)
วัตถุประสงค์: เก็บข้อความอีเมลและไฟล์แนบที่เกี่ยวข้องกับรายงาน
คุณสมบัติ:
- ปริมาณข้อมูลน้อย
- รองรับการเก็บเทมเพลตรายงานและไฟล์ที่สร้าง
โครงสร้างตารางหลัก:
| table name | Instructions | key field |
|---|---|---|
tbl_reports | Report Configuration | id, name, uuid, expression (JSON), is_enabled, last_run_datetime_utc, next_run_datetime_utc, is_run_immediately |
tbl_reports_files | report document | id, uuid, create_datetime_utc, file_name, file_type (xlsx/pdf/docx), file_object (LONGBLOB) |
tbl_template_files | Report Template File | id, uuid, report_id, file_name, file_type, file_object |
tbl_email_messages | Email message | id, recipient_name, recipient_email, subject, message, attachment_file_name, attachment_file_object, status |
หมายเหตุสำหรับการพัฒนา:
- ไฟล์รายงานรองรับ Excel, PDF, Word
- ไฟล์เทมเพลตใช้สำหรับสร้างรายงาน
- รายงานรอง รับทั้งการสร้างตามเวลาและสร้างทันที
- ไฟล์เก็บด้วย
LONGBLOBต้องระวังขนาดไฟล์
13. myems_production_db (ฐานข้อมูลการผลิต)
วัตถุประสงค์: เก็บข้อมูลผลิตภัณฑ์ที่เกี่ยวข้องกับการผลิต
ลักษณะ:
- ปริมาณข้อมูลน้อย
- ใช้สำหรับวิเคราะห์ความสัมพันธ์กับการใช้พลังงานในการผลิต
โครงสร้างตารางหลัก:
| table name | Instructions | key field |
|---|---|---|
tbl_products | Product Information | id, name, uuid, unit_of_measure, tag, standard_product_coefficient |
tbl_teams | Team Information | id, name, uuid, description |
tbl_shifts | Shift information | id, shopfloor_id, team_id, product_id, product_count, start_datetime_utc, end_datetime_utc, reference_timestamp |
tbl_shopfloor_hourly | Workshop hourly output | id, shopfloor_id, start_datetime_utc, product_id, product_count |
tbl_space_hourly | Space hour output | id, space_id, start_datetime_utc, product_id, product_count |
tbl_shopfloors_products | Workshop and product association | id, shopfloor_id, product_id |
tbl_shopfloors_teams | Workshop and team association | id, shopfloor_id, team_id |
ข้อควรระวังในการพัฒนา:
- ข้อมูลการผลิตใช้คำนวณการใช้พลังงานต่อหน่วยผลิตภัณฑ์
- รองรับสถิติตามมิติต่าง ๆ เช่น ผลิตภัณฑ์ ทีม โรงงาน ฯลฯ
- เชื่อมโยงกับข้อมูลพลังงานเพื่อคำนวณตัวชี้วัดประสิทธิภาพ
data-flow-relationship (ความสัมพันธ์ของกระแสข้อมูล)
กระบวนการรวบรวมข้อมูล
กระแสการรับข้อมูล
อุปกรณ์ / เซ็นเซอร์
↓ (Modbus TCP / MQTT / HTTP)
myems-modbus-tcp (บริการรวบรวมข้อมูล)
↓ (เขียน)
myems_historical_db.tbl_analog_value / tbl_digital_value / tbl_energy_value
↓ (การปกติ화ข้อมูล)
myems-normalization (บริการปกติ화)
↓ (การทำความสะอาดข้อมูล)
myems-cleaning (บริการทำความสะอาด)
↓ (การรวมข้อมูล)
myems-aggregation (บริการรวม)
↓ (เขียน)
myems_energy_db (ข้อมูลพลังงาน)
myems_billing_db (ข้อมูลการเรียกเก็บเงิน)
myems_carbon_db (ข้อมูลการปล่อยมลพิษคาร์บอน)
กระแสการค้นหาข้อมูล
คำขอของผู้ใช้
↓
myems-api (บริการ API)
↓ (ค้นหา)
myems_system_db (ข้อมูลกำหนดค่า)
myems_historical_db (ข้อมูลประวัติ)
myems_energy_db (ข้อมูลพลังงาน)
↓ (ตอบสนอง)
myems-web / myems-admin (การแสดงบนหน้าแอปพลิเคชันฝั่งหน้า)
แผนภาพความสัมพันธ์ข้อมูล
myems_system_db.tbl_points
↓ (point_id)
myems_historical_db.tbl_analog_value
↓ (การคำนวณรวม)
myems_energy_db.tbl_meter_hourly
↓ (ลิงก์)
myems_system_db.tbl_meters
↓ (ลิงก์)
myems_system_db.tbl_equipments
↓ (ลิงก์)
myems_system_db.tbl_spaces
table-structure-design-specification (ข้อกำหนดการออกแบบโครงสร้างตาราง)
ฟิลด์ทั่วไป
ทุกตารางมีฟิลด์ทั่วไปต่อไปนี้:
| ชื่อฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
id | BIGINT NOT NULL AUTO_INCREMENT | คีย์หลัก เพิ่มอัตโนมัติ |
name | VARCHAR(255) | ชื่อ |
uuid | CHAR(36) | UUID ใช้สำหรับบูรณาการระบบภายนอก |
description | VARCHAR(255) | คำอธิบาย (ไม่บังคับ) |
ฟิลด์เวลา
| ชื่อฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
utc_date_time | DATETIME | เวลา UTC (ตารางข้อมูลประวัติ) |
start_datetime_utc | DATETIME | เวลาเริ่มต้นของช่วงเวลา (ตารางข้อมูลรวม) |
created_datetime_utc | DATETIME | เวลาสร้าง |
updated_datetime_utc | DATETIME | เวลาอัปเดต |
last_run_datetime_utc | DATETIME | เวลาเรียกใช้งานล่าสุด |
next_run_datetime_utc | DATETIME | เวลาเรียกใช้งานถัดไป |
คำเตือน: ทุกฟิลด์เวลาควรใช้เวลา UTC เป็นหนึ่งเดียว และการแสดงบนหน้าแอปพลิเคชันฝั่งหน้าจะแปลงเป็นเวลาท้องถิ่น
ฟิลด์ตัวเลข
| ชื่อฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
actual_value | DECIMAL(21, 6) | ค่าจ ริง รองรับความแม่นยำสูง (ทศนิยม 6 ตำแหน่ง) |
set_value | DECIMAL(21, 6) | ค่าที่ตั้ง |
rated_capacity | DECIMAL(21, 6) | ความจุที่กำหนด |
rated_power | DECIMAL(21, 6) | พลังงานที่กำหนด |
ฟิลด์ JSON
| ชื่อฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
connection | LONGTEXT | กำหนดค่าการเชื่อมต่อ (รูปแบบ JSON) |
expression | LONGTEXT | นิพจน์ (รูปแบบ JSON) |
payload | LONGTEXT | โหลด (รูปแบบ JSON) |
data | LONGTEXT | ข้อมูล (รูปแบบ JSON) |
หมายเหตุ: ฟิลด์ JSON เก็บสตริง JSON ที่มีรูปแบบ และต้องแยกวิเคราะห์ก่อนใช้
ฟิลด์สถานะ
| ชื่อฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
is_enabled | BOOL | เปิดใช้งานหรือไม่ |
is_active | BOOL | สถานะการเปิดใช้งาน |
is_bad | BOOL | มีข้อมูลเสียหรือไม่ |
is_published | BOOL | ได้รับการเผยแพร่หรือไม่ |
is_counted | BOOL | รวมในสถิติหรือไม่ |
status | VARCHAR(32) | สถานะ (ตัวอย่าง: new, sent, done, error) |
การออกแบบดัชนี
ดัชนีคีย์หลัก:
- ทุกตารางมี
PRIMARY KEY (id)
ดัชนีไม่ซ้ำ:
- ฟิลด์หลัก (เช่น
name,uuid) มักมีดัชนีไม่ซ้ำ
ดัชนีรวม:
- สร้างดัชนีรวมสำหรับชุดฟิลด์ที่ค้นหาบ่อย
- ตัวอย่าง:
(point_id, utc_date_time),(meter_id, start_datetime_utc)
ดัชนีเวลา:
- ฟิลด์เวลามักมีดัชนีแยกต่างหากและรองรับค้นหาช่วงเวลา