Detectorها و مشکلات مرجع

معماری Detectorها

آشکارساز (Detector)

‏Detector الگوریتمی است که مجموعهٔ داده‌ای مشخصی را تحلیل می‌کند و یافته‌ای صورت‌بندی‌شده تولید می‌کند.

‏Detector اجرای کار را مدیریت نمی‌کند و متن آزاد تولید نمی‌کند. خروجی آن قالبی ساختارمند دارد.

detector_id: archive.tail_gap.v3
detector_version: '3.2.1'
run_id: 'run-20260723-0400'
asset_id: 'station-5690'
observed_at: '2026-07-23T04:00:00Z'

finding:
  canon: no_hourly_archive
  detected: true
  severity: critical
  confidence: 0.98
  value: 73
  unit: 'hours'
  threshold: 24
  baseline: 0

evidence:
  last_valid_hour: '2026-07-20T03:00:00Z'
  expected_end: '2026-07-23T04:00:00Z'
  missing_hours: 73

زنجیرهٔ Detector → Canon → Issue

flowchart TD
  D["Detector"] -->|"طبقه‌بندی"| C["Canon"]
  C -->|"مدیریت"| I["Operational Issue"]

• Detector — الگوریتمی مشخص؛
• Canon — گونه‌ای پایدار از مشکل بهره‌برداری؛
• Operational Issue — نمونه‌ای از آن مشکل در بستری مشخص.

چند Detector متفاوت می‌توانند یک Canon واحد را تأیید کنند.

مثال:

flowchart TD
  D1["archive.tail_gap.v3"] --> CANON["no_hourly_archive"]
  D2["archive.coverage.v2"] --> CANON
  D3["archive.delivery_queue.v1"] --> CANON
  D4["session.freshness.v4"] --> CANON
  CANON --> ISSUE["OHM-2026-001842"]

کلاس‌های Detector

الزامات هر Detector

هر Detector عملیاتی این موارد را دارد:

• شناسهٔ یکتای detector_id؛
• نسخهٔ معنایی؛
• کاربرد اعلام‌شده؛
• مالک؛
• شرح داده‌های ورودی؛
• آستانه‌های کنترل‌شده؛
• قواعد استثنا؛
• الزام‌های کمینهٔ حجم نمونه؛
• گیت‌های DQ؛
• فرمول Severity؛
• فرمول سطح اطمینان؛
• Canon متناظر؛
• مجموعهٔ Evidence؛
• آزمون‌ها؛
• نمونهٔ کنترلی؛
• برآورد هشدارهای کاذب (false positive)؛
• تاریخ راه‌اندازی؛
• گزارش تغییرات؛
• حالت غیرفعال‌سازی و بازگردانی (rollback).

گیت‌های کیفیت داده (DQ)

اگر داده‌های منبع ناقص یا متناقض باشند، Detector نباید سطح اطمینان بالایی تولید کند.

نمونه‌هایی از گیت‌ها:

سلامت Detectorها (Detector Health)

‏OHM کیفیت خودِ Detectorها را پایش می‌کند.

شاخص‌های کلیدی:

• شمار فعال‌شدن‌ها؛
• سهم فعال‌شدن‌های تأییدشده؛
• نرخ هشدارهای کاذب؛
• سهم لغوهای دستی؛
• سهم بازگشایی‌های مجدد؛
• توزیع سطح اطمینان؛
• رانش (drift) داده‌های ورودی؛
• تغییر ساختار نمونه؛
• میانگین زمان تا تأیید؛
• نسخهٔ الگوریتم؛
• شمار Issueهای فعال به تفکیک نسخه.

مشکلات مرجع (Canon)

‏Canon طبقه‌بندی پایدارِ یک مشکل در سطح کسب‌وکار است که به پیاده‌سازی مشخصی از Detector وابسته نیست.

چرا به Canon نیاز است

بدون Canon، یک سامانهٔ تحلیلی به‌سرعت به مجموعه‌ای از پیام‌های ناهماهنگ تنزل می‌کند:

• archive_missing
• no_archive
• archive_gap
• hourly_data_absent
• delivery_error

‏Canon همهٔ این سیگنال‌های هم‌ارز را زیر یک شناسهٔ واحد گرد می‌آورد: canon: no_hourly_archive.

این کار موارد زیر را فراهم می‌کند:

• یک چرخهٔ کاری واحد؛
• یک SLA واحد؛
• تحلیل‌های شفاف؛
• KPIهای پایدار؛
• پایگاه دانش مشترک (Knowledge Base)؛
• قابلیت مقایسه میان نسخه‌ها؛
• ترجمهٔ رابط کاربری بدون تغییر منطق؛
• یکپارچه‌سازی با سامانه‌های بیرونی.

ساختار Canon

canon_id: no_hourly_archive
name: 'Hourly archive is missing'
domain: archive
default_owner_zone: backend_integration
default_priority: P1
actionable: true
verification_mode: data
sla_policy: archive_p1
suppression_group: communication_archive
knowledge_tags:
  - archive
  - delivery
  - communication

مجموعهٔ پایهٔ Canonها

نسخه‌بندی Canonها

تغییر متن یا ترجمه، مستلزم تغییر شناسه نیست.

نسخهٔ تازهٔ Canon زمانی لازم است که یکی از این موارد تغییر کند:

• معنای کسب‌وکاری؛
• قاعدهٔ تخصیص؛
• معیار actionability؛
• روش راستی‌آزمایی؛
• اصل SLA؛
• منطق ادغام با مشکلات دیگر.

تحلیل کیفیت Detectorها

‏Operational Health Matrix نه‌تنها تجهیزات، بلکه کیفیت الگوریتم‌های تحلیلی خود را نیز ارزیابی می‌کند.

سامانه برای هر Detector این موارد را محاسبه می‌کند:

• Accuracy؛
• Precision؛
• Recall؛
• False Positive Rate؛
• False Negative Rate؛
• میانگین سطح اطمینان؛
• Drift؛
• Stability؛
• میانگین زمان راستی‌آزمایی؛
• نرخ پذیرش.

چنین رویکردی امکان می‌دهد مدل تحلیلی پلتفرم IIoT پیوسته بهبود یابد، بی‌آنکه تکرارپذیری نتایج آسیب ببیند.

خودِ سبد Detectorها بر پایهٔ نقشهٔ راهی مرحله‌ای تکامل می‌یابد: Detectorهای تازه در قالب موج‌ها معرفی می‌شوند و گشایش هر موج به آمادگی APIهای زیرین پلتفرم گره خورده است.