# صِل معداتك. حوّل بياناتها إلى خدمات صيانة.

> أنت تقدم الأتمتة وتعرف العميل. تقدم Wertek AI المنصة لمراقبة الأصول وتسجيل الملاحظات وإدارة أوامر العمل وتقديم خدمة دورية.

لشركات التكامل · Wertek AI · https://wertek.ai/ar/integrators/

**دخول:** Modbus RTU/TCP · MQTT · OPC UA · HTTP → Wertek AI → **خروج إلى:** SCADA / HMI · نظام أرشفة بيانات العمليات

**للقراءة فقط: لا تكتب Wertek AI إلى PLC لديك.**

## تدخل بروتوكولاتك. يقرأ نظام SCADA لديك الحالة باستخدام مفتاح API بصلاحية القراءة فقط.

انقر على أي خط لمعرفة ما يمثله وكيف يتصل وحالته.

**Wertek AI:** أصل · حالة · تنبيه · أمر عمل · تقرير

### دخول

#### OT · أرض المصنع

- **[بوابة Wertek AI](https://wertek.ai/energy/gateway/)** — Modbus RTU/TCP، مع خرائط سجلات لـ 32 جهازاً من 17 علامة تجارية (Eastron، Schneider، Siemens، Circutor، ABB، Janitza، Carlo Gavazzi…) وبنوك المكثفات. المعدات ترسل تقاريرها بهذه الطريقة بالفعل.
- **أجهزة تنشر عبر MQTT** *(مع التهيئة)* — Banner DXM (اهتزاز لاسلكي، مع مودم 4G)، ومجموعات Acrel وعدادات الطاقة. المعدات ترسل تقاريرها بهذه الطريقة بالفعل.
- **تدفقك الخاص عبر HTTP بمفتاح** *(عبر Node-RED / Ignition / بوابة)* — Node-RED أو Ignition أو n8n أو Python أو JavaScript/TypeScript؛ وصفات لـ Modbus TCP وMQTT وOPC UA، تم التحقق منها بقيم محاكاة.
- **OPC UA من Bently Nevada System 1** *(Beta)* — موصل قراءة.
- **[في الميدان، بالهاتف](https://wertek.ai/ar/mobile/)** — ملاحظات مع صور، وفيديو باستخدام VibeDiag، وتحليل صوتي وقراءات يدوية (ساعات، دورات، kWh…).

> S7 وEtherNet/IP وOPC UA العام: لا نملك برنامج تشغيل خاصاً بنا؛ تصل إليها عبر Node-RED أو Ignition أو بوابة.

#### IT · أنظمة الأعمال

- **الصيانة وERP** — تجلب أوامر العمل الخاصة بها: SAP PM (Pilot-ready), Odoo (Pilot-ready), SAP B1 (In development).
- **ملفات** — أصول من CSV أو Excel، تُراجع قبل تطبيقها؛ وإشارات WAV وUFF58 وCSV.

### خروج

#### OT · أرض المصنع

- **أنظمة أرشفة بيانات العمليات في المصنع** — تكتب Wertek AI قياساتها وصحة الأصول في نظام أرشفة بيانات العمليات، بجانب بيانات العمليات لديك: AVEVA PI (Validated), AVEVA Data Hub (Pilot-ready).
- **SCADA أو HMI أو Node-RED بمفتاح قراءة** — يقرأ Ignition أو Node-RED أو برنامج نصي الأصول والقياسات مع نتائجها وتوصياتها والطاقة، لعرض الحالة بجانب tag العمليات. يُنشأ مفتاح القراءة بدءاً من خطة Monitoring.

> لا تكتب Wertek AI إلى PLC لديك: تنشر الوقائع والحالات، وأنت تقرر أي tag تعدّل.

#### IT · أنظمة الأعمال

- **API بمفتاح** — أصول وقياسات وإشارة وFFT وطاقة؛ تصدير بصيغة JSON. يُنشأ مفتاح القراءة بدءاً من خطة Monitoring.
- **تنزيلات** — CSV وXLSX وParquet وWAV وPDF: قياسات وملاحظات وأوامر عمل واستهلاك وتقرير الامتثال لكود الشبكة الكهربائية.
- **تنبيهات** — إشعارات فورية وبريد إلكتروني، ومباشرة في التطبيق.
- **تقارير دورية بالبريد الإلكتروني** — الطاقة والامتثال لكود الشبكة الكهربائية، والحالة، والملخص الشهري لمراكز الاستهلاك.
- **[الصيانة وERP](https://wertek.ai/ar/integrations/)** — موصلات، لكل منها حالته المدققة: MaintainX (Pilot-ready), Odoo (Pilot-ready), Fracttal (Pilot-ready), SAP B1 (In development).

## HTTP مع مفتاح: المسار لأي جهاز

1. **أنشئ حسابك المجاني.** على app.wertek.ai. يعمل مفتاح بصلاحية الاستيعاب فقط مع أي خطة. [إنشاء حساب](https://app.wertek.ai/signup)
2. **أنشئ الأصل وعيّن نقطة القياس.** سجّل الأصل في التطبيق وعيّن الموضع الذي ستغذيه: رمزه ومتغيراته مع وحدة UCUM ودوريته. يمكنك أيضاً تعيينه بالمفتاح: POST /iaes/assets/{asset_id}/measurement-points. يستهلك التعيين نقطة قياس: نفّذه مرة واحدة لكل موضع، لا عند كل إرسال.
3. **أنشئ مفتاح الاستيعاب.** في الإعدادات → مفاتيح API (Settings → API Keys)، بصلاحية الاستيعاب. احفظه سراً: في متغير بيئة، وليس في الشفرة أو في وسم أبداً.
4. **أرسل القراءة.** حدث asset.measurement واحد لكل قراءة، منفرداً أو في قائمة تصل إلى 100، إلى POST https://api.wertek.ai/iaes/ingest. يتضمن الرد رمزاً لكل حدث؛ وتظهر البيانات المخزنة في سجل الأصل تحت الموضع المعيّن.

### كيفية تعيين نقطة قياس

1. **في Measurement points (أو في الأصل)، انقر على «Designate position».** يستهلك التعيين نقطة قياس واحدة من رصيد مؤسستك: مرة واحدة لكل موضع، لا عند كل إرسال.
2. **أدخل الرمز والقالب والدورية.** الرمز هو قيمة `location` التي سيرسلها تكاملك (بأحرف صغيرة، دون مسافات). يوفّر القالب متغيرات العائلة مع وحدة UCUM الخاصة بها؛ ويمكنك إضافة متغيرات مخصصة. تحدد الدورية المتعاقد عليها، بالثواني، وتيرة إرسال القراءة.

   ![مربع الحوار «Designate a measurement position»: الرمز والقالب والمتغيرات والدورية](https://wertek.ai/assets/images/integrators/designar-dialogo-en.webp)

3. **يظهر الموضع في القائمة ويبدأ باستقبال القراءات.** يُحفظ كل حدث ترسله بهذا الرمز ومفتاح الاستيعاب في سجل الأصل، تحت ذلك الموضع.

### الحدث (reading.json)

```json
{
  "spec_version": "2.0",
  "event_id": "6f1c2b7e-3d4a-4e8b-9a10-5c2d7e9f1a34",
  "correlation_id": "0b8e4c21-7f3a-4d6e-8c95-1a2b3c4d5e6f",
  "event_type": "asset.measurement",
  "timestamp": "2026-11-11T14:32:00Z",
  "source": "plant_x.plc_12",
  "dataschema": "https://iaes.dev/schema/v2/asset.measurement",
  "asset": {
    "asset_id": "PUMP-07"
  },
  "data": {
    "measurement_type": "temperature",
    "value": 23.5,
    "unit": "Cel",
    "location": "zona_1"
  }
}
```

تم التحقق باستخدام SDK المنشور IAES 2.0.2، وهو الإصدار الذي تستخدمه خدمة الاستيعاب.

- `data.location` — رمز الموضع المعيّن
- `data.measurement_type` — مفتاح المتغير
- `data.unit` — وحدة العقد (تُقارَن ولا تُحوَّل أبداً)
- `data.value` — رقم؛ تُنقل القيم المنطقية بصيغة 0 أو 1
- `timestamp` — وقت القياس بتوقيت UTC — وليس وقت الإرسال
- `event_id` — جديد لكل قراءة؛ وهو مفتاح عدم تكرار الأثر

### curl

```bash
curl -X POST https://api.wertek.ai/iaes/ingest \
  -H "X-API-Key: $WERTEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d @reading.json
```

### Python

```python
# pip install requests          (the validator: pip install "iaes[validate]==2.0.2")
import json, os, uuid
from datetime import datetime, timezone
import requests

event = json.load(open("reading.json"))
event["event_id"] = str(uuid.uuid4())         # new for each reading
event["correlation_id"] = str(uuid.uuid4())   # one per batch
event["timestamp"] = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")  # when it was measured

r = requests.post(
    "https://api.wertek.ai/iaes/ingest",
    json=[event],
    headers={"X-API-Key": os.environ["WERTEK_API_KEY"]},
    timeout=30,
)
print(r.status_code, r.json())
```

### Node-RED

```bash
cd ~/.node-red
npm install node-red-contrib-iaes@2.0.2
```

استورد تدفق وصفة الإعداد (pump-process-to-wertek.flow.json)؛ تستخدم عقدة iaes-publish المفتاح نفسه.

### وصفات الإعداد

- **Node-RED.** وصفة إعداد تم التحقق منها برمجياً: يعمل برنامج القبول النصي على API بقيم محاكاة. عُقد IAES 2.0.2 استُوردت وشُغّلت في Node-RED 5.0.6 حقيقي (Docker، 2026-11-12): 5/5 أحداث صالحة. [وصفة الإعداد والتدفق والبرنامج النصي للقبول](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/node-red)
- **n8n.** وصفة إعداد تم التحقق منها باستخدام API في 2026-10-05، دون برنامج نصي تلقائي للقبول. عُقد IAES 2.0.2 استُوردت وشُغّلت في n8n 2.8.4 حقيقي (2026-11-12): 5/5 أحداث صالحة. [وصفة الإعداد وسير العمل](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/_tools/n8n)
- **أي عميل HTTP.** وصفة الإعداد الأساسية: اقرأ عقد الأصل، وعيّن الموضع، وأرسل، واقرأ الرد حدثاً بحدث. [وصفة الإعداد والبرنامج النصي للقبول](https://github.com/wertek-ai/wertek-integrations/tree/main/ot/iaes)

### وماذا عن MQTT؟

يعني MQTT اليوم قنوات لمعدات محددة — Banner DXM ومجموعات Acrel وعدادات الطاقة — لكل منها موضوع وبيانات اعتماد خاصة، تُعدّ مع التهيئة. لا يوجد موضوع شامل: لأي جهاز آخر، المسار هو HTTP بمفتاح.

## ما يحمي بياناتك عند دخولها وما تتحكم فيه

ما يفعله الكود اليوم، ولا شيء أكثر من ذلك.

- **مفاتيح الإدخال.** يبدأ المفتاح بـ wk_ ويُعرض مرة واحدة عند إنشائه. تخزن Wertek AI فقط تجزئة SHA-256 الخاصة به وبادئة من 12 حرفًا للتعرف عليه.
- **الصلاحيات وانتهاء الصلاحية والإلغاء.** يحمل كل مفتاح صلاحياته (telemetry.view, telemetry.export, iaes.ingest)، ويمكن قصره على أصول محددة، ويمكن أن تنتهي صلاحيته خلال 1 إلى 365 يومًا، ويمكن إلغاؤه. لا يدير المفاتيح إلا مالك أو مسؤول.
- **مرتبط بمؤسستك.** لا يُقبل الحدث إلا لأصول المؤسسة التي ينتمي إليها المفتاح: لا يمكن لمفتاح الكتابة إلى أصول مؤسسة أخرى.
- **أثناء النقل.** تُقدَّم API عبر HTTPS. بالنسبة إلى MQTT، استخدم المنفذ 8883 مع TLS.
- **ملفات عبر روابط موقعة.** تُسلَّم اللقطات والمستندات عبر روابط موقعة باستخدام HMAC-SHA256 تنتهي صلاحيتها.
- **البيانات المخزنة.** يشفر مزودونا (Supabase لقاعدة البيانات وCloudflare R2 للملفات) البيانات التي يخزنونها.
- **الحدود والاستخدام.** حتى 300 طلب في الدقيقة لكل بيانات اعتماد آلة (429 عند تجاوز ذلك) و100 حدث لكل دفعة. تسجل API الخاصة بالقياس عن بُعد استخدام كل مفتاح وآخر استخدام له.

### توصيات للمكاملين

- MQTT: المنفذ 8883 مع TLS.
- لا نوصي بإرسال بيانات غير مشفرة. إذا كان جهاز لا يدعم TLS، فتواصل معنا: يمكن تقييمه مع وسائل حماية أخرى.
- مفتاح واحد لكل موقع، بأقل صلاحية (iaes.ingest لإرسال البيانات) وبتاريخ انتهاء صلاحية.
- احتفظ بالمفتاح في متغير بيئة أو مخزن للأسرار، ولا تضعه أبدًا في الكود أو التدفق.
- ألغِ المفتاح عند خروج جهاز أو موقع من الخدمة.

## حزم منشورة مع شفرتها المصدرية المفتوحة

- **Node-RED** — `npm install node-red-contrib-iaes@2.0.2`. سبع عقد: measurement وhealth وwork-order وvalidate وsparkplug وpublish وroute. الإصدار المنشور: 2.0.2 · [الشفرة المصدرية](https://github.com/wertek-ai/iaes/tree/nodered-v2.0.2/node-red) · [npm](https://www.npmjs.com/package/node-red-contrib-iaes)
- **n8n** — `npm install n8n-nodes-iaes@2.0.2`. عقدة مجتمعية لـ n8n. الإصدار المنشور: 2.0.2 · [الشفرة المصدرية](https://github.com/wertek-ai/iaes/tree/n8n-v2.0.2/n8n-nodes) · [npm](https://www.npmjs.com/package/n8n-nodes-iaes)
- **JavaScript / TypeScript** — `npm install @iaes/sdk@2.0.2`. عميل ونماذج والتحقق من الحدث (يستخدم التحقق ajv). الإصدار المنشور: 2.0.2 · [الشفرة المصدرية](https://github.com/wertek-ai/iaes/tree/sdk-v2.0.2/npm) · [npm](https://www.npmjs.com/package/@iaes/sdk)
- **Python** — `pip install "iaes[validate]==2.0.2"`. نماذج والتحقق: أداة التحقق نفسها التي تستخدمها خدمة استيعاب Wertek AI. الإصدار المنشور: 2.0.2 · [الشفرة المصدرية](https://github.com/wertek-ai/iaes/tree/py-v2.0.2/src/iaes) · [PyPI](https://pypi.org/project/iaes/)

**معاينة.** Arduino Opta: يصدر iaes-opta-runtime أحداث IAES 1.4، وتطلب خدمة استيعاب Wertek AI الإصدار 2.x. هذه معاينة وليست للاستخدام الإنتاجي. [iaes-opta-runtime](https://github.com/wertek-ai/iaes-opta-runtime)

**IAES: ابنِ التدفق مرة واحدة.** صيغة أحداث مفتوحة، يُعاد استخدامها مع كل عميل، وما يحصل عليه عميلك في Wertek AI. [عرض IAES لمسؤولي التكامل](https://wertek.ai/ar/integrators/iaes/index.md)

المعيار: IAES 2.0، مفتوح (CC BY 4.0). [iaes.dev](https://iaes.dev/) · [DOI 10.5281/zenodo.22663498](https://doi.org/10.5281/zenodo.22663498)

## أكثر من مكان لتخزين البيانات

- **الأصل وسجله.** تبقى كل قراءة في سجل الأصل، تحت الموضع الذي عيّنته.
- **الملاحظات.** يسجل فريق العميل ما يجده في الميدان، مع الصور، من الويب أو الهاتف.
- **أوامر العمل.** لاتخاذ إجراء بناءً على ما وُجد والاحتفاظ بسجل لكل تدخل. بدءاً من Technical.
- **تطبيق الهاتف.** للعمل الميداني، على Android وiPhone.

## استقبال البيانات مجاني؛ مراقبتها ليست مجانية.

ما تدفع مقابله هو نقطة القياس المراقبة، وليس الأصل.

- 1 نقطة قياس: USD 36 سنوياً
- حزمة من 5 نقطة قياس: USD 120 سنوياً

الأسعار من كتالوج Wertek AI الحالي، كما قُرئت عند نشر هذه الصفحة. [عرض جميع الخطط](https://wertek.ai/pricing.html)

## عميلك يحكم الأصل؛ وأنت ترى ما يسمح لك به

- الأصل وسجله ملك لمن يحكمه: عميلك. وما تسجله يبقى منسوباً إليك.
- ترى ما يسمح لك به عميلك: حسب المصنع أو المنطقة أو الأصل، ضمن نوافذ زمنية.
- بشكل افتراضي، يدفع عميلك تكلفة نقاط القياس.
- إذا انتهى تعاونكما، يبقى الأصل وسجله التقني لدى عميلك؛ وينتهي وصولك عند إلغائه.

[حول Growth Program](https://wertek.ai/growth-program.html)

## ما تقبله خدمة الاستيعاب

| | |
|---|---|
| المسار | POST https://api.wertek.ai/iaes/ingest |
| الترويسة | X-API-Key، بصلاحية iaes.ingest |
| الحدث | IAES, spec_version 2.x |
| الدفعة | حتى 100 حدث لكل طلب |
| الحد | 300 طلب في الدقيقة لكل مفتاح |
| الدورية | تُسقط القراءة التي تصل قبل انقضاء 90 % من الدورية المتعاقد عليها (الرمز 504) |
| عقد الأصل | GET /iaes/assets/{asset_id}/measurement-points، مع المفتاح |
| المخطط والرموز | GET /iaes/schema و/iaes/schema/codes، مع المفتاح |
| الرد | رمز واحد لكل حدث: 1xx تم التخزين · 2xx تم التخزين مع تحذير · 4xx صحّح الرسالة · 5xx أعد المحاولة |

## الأسئلة الشائعة

**هل أحتاج إلى خطة؟** لا تحتاج إلى خطة لإرسال البيانات؛ تُدفع تكلفة كل نقطة قياس مراقبة وفق الكتالوج. تفعّل الخطة تنبيهات تصل إلى شخص، وأوامر العمل، وسجلاً أطول.

**أين تعمل؟** الاستيعاب خدمة سحابية من Wertek AI. أما بوابة Wertek AI فتعمل على شبكتك: تقرأ المعدات وتدفع القراءات.

**هل تكتب خدمة الاستيعاب إلى وحدة PLC لديّ؟** لا. خدمة الاستيعاب تستقبل البيانات فقط.

**ماذا لو أرسلت أسرع من الدورية؟** تُسقط القراءة التي تصل قبل انقضاء 90 % من الدورية المتعاقد عليها بالرمز 504. اضبط الإرسال وفق دورية نقطة القياس.

