كل الصفحات ☰
كل طرق الربط في صفحة واحدة.
ركّب الـJavaScript Widget أو Chrome Extension، مرّر هوية المستخدم، واختياريًا أرسل الأحداث إلى Webhook آمن.
المستخدم يأتي من نظامك
PentaScope لا يحاول تخمين المستخدم. نظامك يمرّر بيانات الـLogin الحالية، ولذلك يظهر البلاغ باسم الشخص الحقيقي وID والجلسة. لو الصفحة عامة، يتسجل كزائر مجهول بدون اختراع اسم.
id · name · email · role · sessionلا ترسل Password أو Access Token الخاص بالمستخدم.مسار الربط
هوية المستخدم
الـWidget يأخذ ID والاسم والبريد والدور من المستخدم المسجل حاليًا. لو لا يوجد Login، يسجل Anonymous مع Session ID.
إنشاء البلاغ
البلاغ يُحفظ داخل PentaScope مع المسار والشاشة والعنصر والدليل والـRequest/Response.
الربط الاختياري
استخدم Webhook عام، وحدد هل يُرسل وقت البلاغ أو بعد الموافقة أو في الحالتين.
مزامنة الحالة
الـConnector يستقبل issue.created أو issue.approved ويرجع رابط المهمة الخارجية للنظام.
إعداد واحد لكل نظام
<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 آمن على السيرفر؛ هو المسؤول عن المصادقة والتحويل إلى أي نظام خارجي تختاره لاحقًا.
شكل الـAPI والبيانات
POST /api/issuesJSONsystem · route · screen · user · request/response · evidence
POST /api/test-runsJSONmode · scenarios · cases · status · duration · issues
POST /api/project-documentsJSONSRS / Test Cases → requirements → traceability
POST /api/test-commandsJSONproject · role · data profile · selected requirements
GET /api/system-logsJSONfrontend · API · upload · agent errors
{ ok, id, status, correlationId, durationMs, errors[] }نفس الـCorrelation ID يربط حركة الواجهة بطلب الـAPI والـLog والـBug.Webhooks عامة وقابلة للتوسعة
issue.created
إرسال حدث فور اكتشاف المشكلة.
issue.approved
إرسال المشكلة بعد مراجعة المسؤول.
Status sync
حفظ رابط المرجع وحالة الإرسال وإعادة المحاولة.
المفاتيح تبقى على السيرفر
لا تضع أي مفتاح لنظام خارجي داخل كود الصفحة. الـWidget يرسل البلاغ إلى Connector آمن يحتفظ بالأسرار على السيرفر.