كل الصفحات
Englishتسجيل الدخول
الرئيسيةSRS والـUser Storiesتجربة اختبار صفحةاختبار نظام كاملدليل المشروعتسجيل الدخولEnglish

كل طرق الربط في صفحة واحدة.

ركّب الـJavaScript Widget أو Chrome Extension، مرّر هوية المستخدم، واختياريًا أرسل الأحداث إلى Webhook آمن.

01

المستخدم يأتي من نظامك

PentaScope لا يحاول تخمين المستخدم. نظامك يمرّر بيانات الـLogin الحالية، ولذلك يظهر البلاغ باسم الشخص الحقيقي وID والجلسة. لو الصفحة عامة، يتسجل كزائر مجهول بدون اختراع اسم.

المطلوب من النظام المضيفid · name · email · role · sessionلا ترسل Password أو Access Token الخاص بالمستخدم.
02

مسار الربط

1

هوية المستخدم

الـWidget يأخذ ID والاسم والبريد والدور من المستخدم المسجل حاليًا. لو لا يوجد Login، يسجل Anonymous مع Session ID.

2

إنشاء البلاغ

البلاغ يُحفظ داخل PentaScope مع المسار والشاشة والعنصر والدليل والـRequest/Response.

3

الربط الاختياري

استخدم Webhook عام، وحدد هل يُرسل وقت البلاغ أو بعد الموافقة أو في الحالتين.

4

مزامنة الحالة

الـConnector يستقبل issue.created أو issue.approved ويرجع رابط المهمة الخارجية للنظام.

03

إعداد واحد لكل نظام

<script src="https://pentascope.example.com/qa-widget.js"></script>
<script>
QATest.init({
  apiUrl: "https://pentascope.example.com/api",
  token: "YOUR_WIDGET_TOKEN",
  system: "My Product",

  // من الـLogin الحالي في نظامك
  user: () => ({
    id: currentUser.id,
    name: currentUser.name,
    email: currentUser.email,
    role: currentUser.role
  }),

  userStory: () => currentStory,
  tracker: {
    provider: "generic-webhook",
    createOn: "report",    // report | approve | both
    project: "Engineering",
    board: "Product Bugs",
    webhookUrl: "https://YOUR-SERVER/qa-connector"
  }
});
</script>

وجّه webhookUrl إلى Connector آمن على السيرفر؛ هو المسؤول عن المصادقة والتحويل إلى أي نظام خارجي تختاره لاحقًا.

04

شكل الـAPI والبيانات

POST /api/issuesJSON

system · route · screen · user · request/response · evidence

POST /api/test-runsJSON

mode · scenarios · cases · status · duration · issues

POST /api/project-documentsJSON

SRS / Test Cases → requirements → traceability

POST /api/test-commandsJSON

project · role · data profile · selected requirements

GET /api/system-logsJSON

frontend · API · upload · agent errors

Response contract{ ok, id, status, correlationId, durationMs, errors[] }نفس الـCorrelation ID يربط حركة الواجهة بطلب الـAPI والـLog والـBug.
05

Webhooks عامة وقابلة للتوسعة

1

issue.created

إرسال حدث فور اكتشاف المشكلة.

2

issue.approved

إرسال المشكلة بعد مراجعة المسؤول.

3

Status sync

حفظ رابط المرجع وحالة الإرسال وإعادة المحاولة.

06

المفاتيح تبقى على السيرفر

لا تضع أي مفتاح لنظام خارجي داخل كود الصفحة. الـWidget يرسل البلاغ إلى Connector آمن يحتفظ بالأسرار على السيرفر.