From dabb871cbb86a8a05e5190c087eb45f3ed5b39f9 Mon Sep 17 00:00:00 2001 From: Timofey Syrokvashko Date: Thu, 4 Sep 2025 18:37:23 +0300 Subject: [PATCH] feat / AEB-20 create csv parser --- README.md | 2 +- .../serializers.py => management/__init__.py} | 0 .../commands/__init__.py} | 0 .../commands/parse_multiplexor_data.py | 64 ++++++ backend/api/parser/parse_csv.py | 191 ++++++++++++++++++ backend/scripts/parse_multiplexor_cron.sh | 12 ++ backend/sitemanagement/admin.py | 2 +- .../migrations/0004_sensor_math_formula.py | 18 ++ backend/sitemanagement/models.py | 2 + frontend/app/favicon.ico | Bin 25931 -> 2966 bytes 10 files changed, 289 insertions(+), 2 deletions(-) rename backend/api/{parser/serializers.py => management/__init__.py} (100%) rename backend/api/{parser/views.py => management/commands/__init__.py} (100%) create mode 100644 backend/api/management/commands/parse_multiplexor_data.py create mode 100644 backend/api/parser/parse_csv.py create mode 100755 backend/scripts/parse_multiplexor_cron.sh create mode 100644 backend/sitemanagement/migrations/0004_sensor_math_formula.py diff --git a/README.md b/README.md index bf36e67..61764c6 100644 --- a/README.md +++ b/README.md @@ -19,7 +19,7 @@ ### Дизайн -- **Figma** - [Дизайн проекта.](https://www.figma.com/design/) +- **Figma** - [Дизайн проекта.](https://www.figma.com/design/BrqSrc886HCCAYRONObOut/%D0%90%D1%8D%D1%80%D0%91%D0%98%D0%9C?node-id=711-11782&p=f&t=nMUhO2Od7DacnQkO-0) ### Тасклист diff --git a/backend/api/parser/serializers.py b/backend/api/management/__init__.py similarity index 100% rename from backend/api/parser/serializers.py rename to backend/api/management/__init__.py diff --git a/backend/api/parser/views.py b/backend/api/management/commands/__init__.py similarity index 100% rename from backend/api/parser/views.py rename to backend/api/management/commands/__init__.py diff --git a/backend/api/management/commands/parse_multiplexor_data.py b/backend/api/management/commands/parse_multiplexor_data.py new file mode 100644 index 0000000..b8a1e49 --- /dev/null +++ b/backend/api/management/commands/parse_multiplexor_data.py @@ -0,0 +1,64 @@ +import os +import logging +from django.core.management.base import BaseCommand +from django.conf import settings +from ...parser.parse_csv import parse_multiplexor_data + +logger = logging.getLogger(__name__) + +class Command(BaseCommand): + help = 'Парсит данные из CSV файлов мультиплексоров' + + def add_arguments(self, parser): + parser.add_argument( + '--data-dir', + type=str, + help='Директория с CSV файлами', + default=os.path.join(settings.BASE_DIR, 'data', 'multiplexors') + ) + + def handle(self, *args, **options): + data_dir = options['data_dir'] + + # проверяем существование директории + if not os.path.exists(data_dir): + logger.error(f"Директория {data_dir} не существует") + return + + # получаем список CSV файлов + csv_files = [f for f in os.listdir(data_dir) if f.endswith('.csv')] + if not csv_files: + logger.info(f"CSV файлы не найдены в директории {data_dir}") + return + + total_metrics = 0 + total_alerts = 0 + errors = [] + + # обрабатываем каждый файл + for csv_file in csv_files: + file_path = os.path.join(data_dir, csv_file) + logger.info(f"Обработка файла: {file_path}") + + try: + result = parse_multiplexor_data(file_path) + + if result['success']: + total_metrics += result['metrics_count'] + total_alerts += result['alerts_count'] + if result['errors']: + errors.extend([f"{csv_file}: {err}" for err in result['errors']]) + else: + errors.extend([f"{csv_file}: {err}" for err in result['errors']]) + + except Exception as e: + error_msg = f"Ошибка при обработке файла {csv_file}: {str(e)}" + logger.error(error_msg) + errors.append(error_msg) + + # выводим итоговую статистику + logger.info(f"Обработка завершена. Создано метрик: {total_metrics}, алертов: {total_alerts}") + if errors: + logger.warning("Обнаружены ошибки:") + for error in errors: + logger.warning(error) diff --git a/backend/api/parser/parse_csv.py b/backend/api/parser/parse_csv.py new file mode 100644 index 0000000..d72cda9 --- /dev/null +++ b/backend/api/parser/parse_csv.py @@ -0,0 +1,191 @@ +import os +import csv +import logging +from datetime import datetime +from pathlib import Path +from typing import Dict, Any + +from sitemanagement.models import Multiplexor, Channel, Sensor, Alert, Metric + +logger = logging.getLogger(__name__) + +def parse_multiplexor_data(csv_file_path: str) -> Dict[str, Any]: + """ + Парсит данные из CSV файла с показаниями мультиплексора. + + Args: + csv_file_path (str): Путь к CSV файлу с данными + + Returns: + Dict[str, Any]: Словарь с результатами парсинга: + - success (bool): Успешно ли выполнен парсинг + - errors (List[str]): Список ошибок, если они есть + - metrics_count (int): Количество созданных метрик + - alerts_count (int): Количество созданных алертов + """ + if not csv_file_path: + logger.error("Не указан путь к файлу") + return { + "success": False, + "errors": ["Не указан путь к файлу"], + "metrics_count": 0, + "alerts_count": 0 + } + # проверяем существование файла + if not os.path.exists(csv_file_path): + logger.error(f"Файл не найден: {csv_file_path}") + return { + "success": False, + "errors": ["Файл не найден"], + "metrics_count": 0, + "alerts_count": 0 + } + + #! шаг 1: извлекаем имя мультиплексора из имени файла + file_name = Path(csv_file_path).stem # получаем имя файла без расширения + + # ищем мультиплексор в базе данных по имени + try: + multiplexor = Multiplexor.objects.get(name=file_name) + except Multiplexor.DoesNotExist: + logger.error(f"Мультиплексор с именем {file_name} не найден") + return { + "success": False, + "errors": [f"Мультиплексор с именем {file_name} не найден"], + "metrics_count": 0, + "alerts_count": 0 + } + + #!TODO -- читать Vmux (напряжение мультиплексора) Tmux (температура мультиплексора) и записывать в базу + + #! шаг 2: проверяем каналы + try: + metrics_count = 0 + alerts_count = 0 + errors = [] + + with open(csv_file_path, 'r') as csvfile: + csv_reader = csv.DictReader(csvfile) + # получаем заголовки CSV - они должны содержать номера каналов + headers = csv_reader.fieldnames + if not headers: + logger.error("CSV файл пуст или неверного формата") + return { + "success": False, + "errors": ["CSV файл пуст или неверного формата"], + "metrics_count": 0, + "alerts_count": 0 + } + + # получаем список каналов из CSV + csv_channels = [h for h in headers if h.startswith('CH-')] + + # получаем каналы мультиплексора из базы + db_channels = Channel.objects.filter(multiplexor=multiplexor) + db_channel_numbers = set(ch.number for ch in db_channels) + + # проверяем соответствие каналов + csv_channel_numbers = set(int(ch.split('-')[1]) for ch in csv_channels) + missing_channels = db_channel_numbers - csv_channel_numbers + extra_channels = csv_channel_numbers - db_channel_numbers + + if missing_channels or extra_channels: + error_msg = [] + if missing_channels: + error_msg.append(f"Отсутствуют каналы: {', '.join(f'CH-{num}' for num in missing_channels)}") + if extra_channels: + error_msg.append(f"Лишние каналы: {', '.join(f'CH-{num}' for num in extra_channels)}") + logger.error(". ".join(error_msg)) + return { + "success": False, + "errors": error_msg, + "metrics_count": 0, + "alerts_count": 0 + } + + #! шаг 3: проверяем датчики в каналах + for row in csv_reader: + # если нет timestamp в CSV, используем текущее время + timestamp = row.get('timestamp', datetime.now().isoformat()) + + for channel_header in csv_channels: + channel_number = int(channel_header.split('-')[1]) + value = row[channel_header] + + # получаем канал и его датчики из базы + try: + channel = db_channels.get(number=channel_number) + sensors = Sensor.objects.filter(channel=channel) + + if not sensors.exists(): + errors.append(f"Канал CH-{channel_number} не имеет настроенных датчиков") + continue + + # проверяем значение для каждого датчика в канале ++ TODO полуканальность + for sensor in sensors: + try: + float_value = float(value) + + + #!TODO -- математические формулы для rowdata + + + + # создаем метрику для каждого значения + metric = Metric.objects.create( + sensor=sensor, + value=float_value, + timestamp=timestamp + ) + metrics_count += 1 + + # проверяем пороговые значения, если они заданы + if sensor.sensor_type.min_value is not None and float_value < float(sensor.sensor_type.min_value): + message = f"Значение {value} в канале CH-{channel_number} ниже минимального порога {sensor.sensor_type.min_value}" + errors.append(f"{message} для датчика {sensor.name or sensor.sensor_type.code}") + + # создаем алерт для нижнего порога + Alert.objects.create( + sensor=sensor, + metric=metric, + sensor_type=sensor.sensor_type, + message=message, + severity="critical" if float_value < float(sensor.sensor_type.min_value) * 0.9 else "warning" + ) + alerts_count += 1 + + if sensor.sensor_type.max_value is not None and float_value > float(sensor.sensor_type.max_value): + message = f"Значение {value} в канале CH-{channel_number} выше максимального порога {sensor.sensor_type.max_value}" + errors.append(f"{message} для датчика {sensor.name or sensor.sensor_type.code}") + + # создаем алерт для верхнего порога + Alert.objects.create( + sensor=sensor, + metric=metric, + sensor_type=sensor.sensor_type, + message=message, + severity="critical" if float_value > float(sensor.sensor_type.max_value) * 1.1 else "warning" + ) + alerts_count += 1 + + except ValueError: + errors.append(f"Некорректное значение {value} в канале CH-{channel_number}") + + except Channel.DoesNotExist: + errors.append(f"Канал CH-{channel_number} не найден в базе данных") + + return { + "success": True, + "errors": errors, + "metrics_count": metrics_count, + "alerts_count": alerts_count + } + + except Exception as e: + logger.error(f"Ошибка при чтении CSV файла: {str(e)}") + return { + "success": False, + "errors": [f"Ошибка при чтении CSV файла: {str(e)}"], + "metrics_count": metrics_count, + "alerts_count": alerts_count + } diff --git a/backend/scripts/parse_multiplexor_cron.sh b/backend/scripts/parse_multiplexor_cron.sh new file mode 100755 index 0000000..050b8ed --- /dev/null +++ b/backend/scripts/parse_multiplexor_cron.sh @@ -0,0 +1,12 @@ +#!/bin/bash + +cd /Users/timofey/Desktop/aerbim-www/backend + +# активация виртуального окружения +source /path/to/virtualenv/bin/activate #!! замени в проде на реальный путь + +# установка переменных окружения +export DJANGO_SETTINGS_MODULE=base.settings + +# запуск команды +python manage.py parse_multiplexor_data --data-dir=/path/to/csv/files >> /var/log/aerbim/multiplexor_parser.log 2>&1 #!! замени в проде на реальный путь diff --git a/backend/sitemanagement/admin.py b/backend/sitemanagement/admin.py index f83e393..7ff1547 100644 --- a/backend/sitemanagement/admin.py +++ b/backend/sitemanagement/admin.py @@ -28,4 +28,4 @@ class SignalFormatAdmin(admin.ModelAdmin): @admin.register(Sensor) class SensorAdmin(admin.ModelAdmin): - list_display = ('channel', 'sensor_type', 'signal_format', 'serial_number', 'name') \ No newline at end of file + list_display = ('channel', 'sensor_type', 'signal_format', 'serial_number', 'name', 'math_formula') \ No newline at end of file diff --git a/backend/sitemanagement/migrations/0004_sensor_math_formula.py b/backend/sitemanagement/migrations/0004_sensor_math_formula.py new file mode 100644 index 0000000..75f28ca --- /dev/null +++ b/backend/sitemanagement/migrations/0004_sensor_math_formula.py @@ -0,0 +1,18 @@ +# Generated by Django 5.2.5 on 2025-09-04 06:59 + +from django.db import migrations, models + + +class Migration(migrations.Migration): + + dependencies = [ + ('sitemanagement', '0003_metric_sitemanagem_timesta_ac22b7_idx_and_more'), + ] + + operations = [ + migrations.AddField( + model_name='sensor', + name='math_formula', + field=models.CharField(blank=True, max_length=255, null=True), + ), + ] diff --git a/backend/sitemanagement/models.py b/backend/sitemanagement/models.py index 0453dd8..8f5579b 100644 --- a/backend/sitemanagement/models.py +++ b/backend/sitemanagement/models.py @@ -85,6 +85,8 @@ class Sensor(models.Model): name = models.CharField(max_length=50, blank=True, null=True) # GA-1, HLE-1 и т.п. created_at = models.DateTimeField(auto_now_add=True) updated_at = models.DateTimeField(auto_now=True) + math_formula = models.CharField(null=True, blank=True, max_length=255) + class Meta: verbose_name = "Датчик" verbose_name_plural = "Датчики" diff --git a/frontend/app/favicon.ico b/frontend/app/favicon.ico index 718d6fea4835ec2d246af9800eddb7ffb276240c..3416e04d8a3c551afcc45c0ea8845de2efd16c4c 100644 GIT binary patch literal 2966 zcmb_e3sg;67{0UC%vgp*B{HO9jLCDnjj?2AA_+w^5{B}&3YAer-5!z>NsZ)@7#T#K zy>9P!xA%iyx~Xm|J(M0w<(vQP%35PCk~w#sd(PQs@BiE9|Ni}bo5%Z%eoFE@?w`jW zz~j*^Z#}ufgiUiImj`ToT!bN0W-h|KtBN1UW7E!jUh;jHH zu}*W4aC`w0-PDodsg3H~P-Ob;$BkVI@HHL<@13J@W}7ljZBfB7gE6@6{2N5!Cs7jP z$zql#UqwZRKc3|Tq9#8abw%-LZKy=gQ4;Hg!axTUN4TR%a17yu9bnuK!KQ;DFdvRE z%h8D7e~W1Q$%u8F1)--7Zkmk3*>#`8L%$!6ukH^=-GSh1OTlsdXe9dVK*0kWJPtWZ zF=-wYUz~UePg8H8GV3m$7bl{#y|o7(&DA0{Us0GVO5?qedutzpOa>uv&p?FyA&1cY zBWX@!5NSJs@-dC&!+)<5-1YmzW%U3Y(Uk&UM;ewZWO36@la0^2dx*a2Fp5H5@FdEE z;+{vj&=-}Nckr^l{0%m{dHotS1yQVTNz56Dg;$V#dO79b%kCTu>&k)kI7G1=%tWNa zESxrw$Kh2{u+|w2bFCq8**pQMK3nkch6!^0Es%fT8jph=>Dyf2a8W0U$Lr3Hf8*0r z`^y&)CtYTBAWr%VrEwP!Vf_sPclAf`URi`%j6nDy6-3&6hv>so5l1y~%VHAvD`l`x zO9tlJBM{)U4B1z&N1wY zbbsXCvtk@@T!ieCr@9=~RhM=X5p!fZqL0qS$xSLSUMvT9qv=RJr-uxmjmYxdhMeoW z84vjsgR3o3*a_5^r1U^ZymEPIZKyy)StjG7IzIx!KbLjYqS+8ui{S^A5Xm1;IhaB@ zn2mc@Gr(Uv4x!E(NIk2I^b2d*8p^)96A%4Nk$ZbT$HL1%8lHwj;bEu%H$z1nH&B6-p(^~W=0oVNfn-{nY3EiWdC@NTN)P2hQLHq7TXueW3Ae7SgxCjC}%Y!p8Od?kEKXC zvl3|+^pSbV0NK7fh=*OY?yghKwf73^?M}7jg*a_I9fwv(5w;9r%VFE1VT7%Kjhd?P zw^2iUw>~AgEn@2?_3W=m_g>F<;P`K?fBJUVUOjhqyh4DN84fNV1ardPtvM81)rUb} zZ3MLEE5p@9o#_Eri*e3BAi?z~;$aDCqz=-~>#-bEKMLs;mZVPNf)pItFb-x*q+zTf zht0nXhu(s(v2>0icCJ|nfy0l8Bu$96pTcx8-eo@VpiVWbMLg)BFu)$|t&NgG_o}VA zz6x=EN8x6sf$f^g(4D7%C9@TwwQw4)+OIYY)$nMVWUdgJQQIE6iKH@7wsk?#&HJXj?JSv zEX0#YcZoXpJ}gP^I@{aGFNCOj9D{063WTwth&{ixOBc;#Ah1xNJScZ-!c>~WOr`-X zb)}NR^{K6`u^P37(KL@FG(Rh3Ivq@U6tqW*<$%*g&NHLPpE!T4Nb~Cx&N~N@KQ&h7 zqn3QTL7a`IszSzZfD!qVS&v66F>TKF-Ojw^ow54(qNA;au(PP9($PeI{VZ3&{2*}m zR|p}05|BS}-uzsY&_{$1599U>Ep=sRtSX?Zm}x8L(LpBCj0bMdA<0`m9Qh-95Eq$yEgR(@QPYc+`(Jx8c3-0srs;Rb* M5rCe3@c(`N2f(xr+5i9m literal 25931 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 LrJugUA?W`A8`#=m