1. Welcomeمرحباً

PX360 is Al Hammadi Hospital's patient experience platform. It lets patients and visitors share feedback — complaints, inquiries, safety observations, appreciation, and suggestions — and track the response. This guide covers everything you need to use the system. نظام PX360 هو منصة تجربة المريض في مستشفى الحمادي. يتيح للمرضى والزوار مشاركة الملاحظات — الشكاوى، الاستفسارات، الملاحظات Safety، الشكر والتقدير، والاقتراحات — وتتبع الردود. يغطي هذا الدليل كل ما تحتاجه لاستخدام النظام.

The Feedback Hubمركز الملاحظات

Visit /core/public/submit/ to see the public feedback hub. You'll find five cards, each for a different type of feedback. Click the one that matches your need. زر /core/public/submit/ لعرض مركز الملاحظات العام. ستجد خمس بطاقات، كل واحدة لنوع مختلف من الملاحظات. انقر على ما يناسب حاجتك.

There is also a "Track Your Submission" card — use it to check the status of something you already submitted (see Section 7). توجد أيضاً بطاقة "تتبع طلبك" — استخدمها للتحقق من حالة ما قدمته مسبقاً (انظر القسم 7).

2. Submit a Complaintتقديم شكوى

Use this form to report an issue with our services. We take all concerns seriously and will investigate thoroughly. استخدم هذا النموذج للإبلاغ عن مشكلة في خدماتنا. نأخذ جميع الشكاوى على محمل الجد وسنحقق فيها بدقة.

How to accessكيفية الوصول

1. Go to /core/public/submit/اذهب إلى /core/public/submit/
2. Click the Complaint card (red icon)انقر على بطاقة الشكوى (أيقونة حمراء)
3. The complaint form will appearسيظهر نموذج الشكوى

Alternatively, go directly to /complaints/public/submit/أو اذهب مباشرة إلى /complaints/public/submit/

Form fieldsحقول النموذج

Cascading dropdown logicمنطق القوائم المتسلسلة

• Hospital + Location Type → determines available Areasالمستشفى + نوع الموقع → يحدد المناطق المتاحة
• Hospital + Category → determines available Departmentsالمستشفى + الفئة → يحدد الأقسام المتاحة
• Department → determines available Sectionsالقسم → يحدد الأقسام الفرعية المتاحة

After you submitبعد الإرسال

You'll see a success page with a reference number starting with CMP- (e.g. CMP-20260708-123456). Save this number — you'll need it to track your complaint. ستظهر صفحة نجاح تحتوي على رقم مرجعي يبدأ بـ CMP- (مثل CMP-20260708-123456). احفظ هذا الرقم — ستحتاجه لتتبع شكواك.

3. Submit an Inquiryتقديم استفسار

Have a question? Use this form to ask about appointments, billing, medical records, pharmacy, insurance, or general information. We'll get back to you within 24–48 hours. لديك سؤال؟ استخدم هذا النموذج للسؤال عن المواعيد، الفواتير، السجلات الطبية، الصيدلية، التأمين، أو المعلومات العامة. سنعاود التواصل معك خلال 24–48 ساعة.

How to accessكيفية الوصول

1. Go to /core/public/submit/اذهب إلى /core/public/submit/
2. Click the Inquiry card (amber icon)انقر على بطاقة الاستفسار (أيقونة صفراء)

Or go directly to /inquiries/public/submit/أو اذهب مباشرة إلى /inquiries/public/submit/

Form fieldsحقول النموذج

After you submitبعد الإرسال

You'll receive a reference number starting with INQ- (e.g. INQ-20260708-123456). Save it to track your inquiry later. ستحصل على رقم مرجعي يبدأ بـ INQ- (مثل INQ-20260708-123456). احفظه لتتبع استفسارك لاحقاً.

4. Submit an Observationتقديم ملاحظة Safety

Help us improve safety by sharing what you've noticed. Anonymous submissions are welcome — providing your information is optional but may help us follow up. ساعدنا في تحسين Safety من خلال مشاركة ما لاحظته. نرحب بالبلاغات المجهولة — تقديم معلوماتك اختياري لكنه قد يساعدنا في المتابعة.

How to accessكيفية الوصول

1. Go to /core/public/submit/ → click Observationاذهب إلى /core/public/submit/ → انقر ملاحظة
2. Or go directly to /observations/new/أو اذهب مباشرة إلى /observations/new/

Form fieldsحقول النموذج

Your Information (all optional — anonymous reporting)معلوماتك (كلها اختيارية — بلاغ مجهول)

After you submitبعد الإرسال

You'll see a success page with a tracking code starting with OBS- (e.g. OBS-ABC123). There's a "Copy Code" button — use it to save the code. You can track your observation with this code. ستظهر صفحة نجاح تحتوي على رمز تتبع يبدأ بـ OBS- (مثل OBS-ABC123). يوجد زر "نسخ الرمز" — استخدمه لحفظ الرمز. يمكنك تتبع ملاحظتك بهذا الرمز.

5. Send Appreciationإرسال شكر وتقدير

Recognize a staff member or team who made a positive difference in your experience. Your kind words will be reviewed and shared with the person or department you recognized. قدّر موظفاً أو فريقاً أحدث فرقاً إيجابياً في تجربتك. سيتم مراجعة كلماتك اللطيفة ومشاركتها مع الشخص أو القسم المعني.

How to accessكيفية الوصول

1. Go to /core/public/submit/ → click Appreciation (green icon)اذهب إلى /core/public/submit/ → انقر شكر وتقدير (أيقونة خضراء)
2. Or go to /appreciation/public/submit/أو اذهب إلى /appreciation/public/submit/

Form fieldsحقول النموذج

After you submitبعد الإرسال

You'll see a "Thank You!" confirmation. An APR- reference number is generated internally but is not publicly trackable. ستظهر رسالة "شكراً لك!". يتم إنشاء رقم مرجعي APR- داخلياً لكنه غير قابل للتتبع العام.

6. Submit a Suggestionتقديم اقتراح

Share your ideas to help us improve our services and facilities for everyone. We appreciate your input and will review it carefully. شارك أفكارك لمساعدتنا في تحسين خدماتنا ومرافقنا للجميع. نقدّر مدخلاتك وسنراجعها بعناية.

How to accessكيفية الوصول

1. Go to /core/public/submit/ → click Suggestion (cyan icon)اذهب إلى /core/public/submit/ → انقر اقتراح (أيقونة سماوية)
2. Or go to /suggestions/public/suggestion/أو اذهب إلى /suggestions/public/suggestion/

Form fieldsحقول النموذج

After you submitبعد الإرسال

You'll see a "Thank You!" confirmation. An SG- reference number is generated but is not publicly trackable. AI automatically categorizes your suggestion and generates a summary. ستظهر رسالة "شكراً لك!". يتم إنشاء رقم مرجعي SG- لكنه غير قابل للتتبع العام. يصنّف الذكاء الاصطناعي اقتراحك تلقائياً ويولّد ملخصاً.

7. Track Your Submissionتتبع طلبك

Use the tracking page to check the status of a complaint, inquiry, or observation you've already submitted. استخدم صفحة التتبع للتحقق من حالة شكوى أو استفسار أو ملاحظة قمت بتقديمها.

How to trackكيفية التتبع

1. Go to /core/public/track/اذهب إلى /core/public/track/
2. Choose the type: Complaint, Inquiry, or Observationاختر النوع: شكوى، استفسار، أو ملاحظة
3. Enter your reference number (found in your confirmation email or SMS)أدخل الرقم المرجعي (موجود في بريد التأكيد أو الرسالة النصية)
4. Click "Track Status"انقر "تتبع الحالة"

Reference number formatsصيغ الأرقام المرجعية

What you'll seeما ستراه

• Status badge — Received, In Progress, Resolved, Closed, or Cancelledشارة الحالة — مستلم، قيد المعالجة، تم الحل، مغلق، أو ملغي
• Progress bar — visual indicator of progressشريط التقدم — مؤشر مرئي للتقدم
• SLA deadline — shown with a red "Overdue" indicator if past dueالموعد النهائي — يظهر بمؤشر أحمر "متأخر" إذا تجاوز الموعد
• Resolution Journey timeline — a timeline of updates, status changes, and department responsesمسار الحل — خط زمني للتحديثات وتغييرات الحالة وردود الأقسام
• Department Response — the response from the relevant department (if available)رد القسم — رد القسم المعني (إن وُجد)

Status meaningsمعاني الحالات

Rate your satisfaction (Complaints only)قيّم رضاك (الشكاوى فقط)

When a complaint is resolved or closed, a satisfaction rating appears on the tracking page. Choose: عند حل الشكوى أو إغلاقها، يظهر تقييم الرضا على صفحة التتبع. اختر:

• 😐 Dissatisfiedغير راضٍ
• 😐 Neutralمحايد
• 😊 Satisfiedراضٍ

8. Complete a Satisfaction Surveyاستبيان رضا المريض

You may receive a satisfaction survey link via SMS or email after a hospital visit. The survey is quick and helps us improve patient care. قد تصلك رسالة أو بريد يحتوي على رابط استبيان الرضا بعد زيارة المستشفى. الاستبيان سريع ويساعدنا في تحسين رعاية المرضى.

How to accessكيفية الوصول

1. Click the survey link in your SMS or emailانقر على رابط الاستبيان في رسالتك أو بريدك
2. The survey page opens — no login requiredتفتح صفحة الاستبيان — بدون تسجيل دخول
3. If the link has expired, you'll see an "invalid token" messageإذا انتهت صلاحية الرابط، ستظهر رسالة "رابط غير صالح"

What you'll seeما ستراه

• Instructions block (if configured)التعليمات (إن وُجدت)
• Consent block (if required — you must check "I agree" before proceeding)الموافقة (إن لزم — يجب الموافقة قبل المتابعة)
• Questions — see types belowالأسئلة — انظر الأنواع أدناه
• Language toggle (EN⇄AR) in the top-right cornerتبديل اللغة (EN⇄AR) في الزاوية العلوية

Question typesأنواع الأسئلة

There may also be an optional "Additional Comments" text box at the end. قد يوجد أيضاً مربع نص اختياري "ملاحظات إضافية" في النهاية.

After you submitبعد الإرسال

You'll see a "Thank You" page confirming your responses were received. If a score was calculated, it may show your overall rating (e.g. "4.5 / 5.0"). You can then safely close the page. ستظهر صفحة "شكراً لك" تؤكد استلام إجاباتك. إذا تم حساب درجة، قد يظهر تقييمك الإجمالي (مثل "4.5 / 5.0"). يمكنك بعدها إغلاق الصفحة بأمان.

9. Logging Inتسجيل الدخول

PX360 requires a staff account. You log in with your email address and password. يتطلب نظام PX360 حساباً للموظف. تسجل الدخول ببريدك الإلكتروني وكلمة المرور.

The login pageصفحة تسجيل الدخول

Go to /accounts/login/اذهب إلى /accounts/login/

• Click "Sign In" to log inانقر "تسجيل الدخول"
• "Forgot password?" link — enter your email to receive a reset link"نسيت كلمة المرور؟" — أدخل بريدك لاستلام رابط إعادة التعيين

Where you go after loginإلى أين تذهب بعد الدخول

If you have no hospital assignedإذا لم يكن لديك مستشفى

Non-admin users without a hospital will see a "No Hospital Assigned" error page (HTTP 403). Contact your administrator to be assigned to a hospital. المستخدمون غير الإداريين بدون مستشفى سيرون صفحة خطأ "لا يوجد مستشفى مخصص" (HTTP 403). تواصل مع المسؤول لتعيين مستشفى لك.

10. Onboarding Wizardمعالج التأهيل

When an administrator invites you to PX360, you'll receive an email with an activation link. Clicking it starts the onboarding wizard — a one-time setup flow that takes about 10–15 minutes. عندما يدعوك المسؤول إلى نظام PX360، ستستلم بريداً يحتوي على رابط التفعيل. النقر عليه يبدأ معالج التأهيل — تدفق إعداد لمرة واحدة يستغرق حوالي 10–15 دقيقة.

The 6 stepsالخطوات الست

Step 1 — Open the activation linkالخطوة 1 — افتح رابط التفعيل

1. Check your email for an invitation from PX360تحقق من بريدك للحصول على دعوة من PX360
2. Click "Complete Account Setup"انقر "إكمال إعداد الحساب"
3. You're logged in automatically — no password needed yetيتم تسجيل دخولك تلقائياً — لا حاجة لكلمة مرور بعد

Step 2 — Welcome pageالخطوة 2 — صفحة الترحيب

• You'll see three cards: Learn, Acknowledge, Signسترى ثلاث بطاقات: تعلم، إقرار، توقيع
• Click "Start Onboarding" to beginانقر "بدء التأهيل"

Step 3 — Review contentالخطوة 3 — مراجعة المحتوى

• Read each onboarding content page (policies, system overview, role info)اقرأ كل صفحة محتوى (السياسات، نظرة عامة، معلومات الدور)
• A progress bar shows your position ("Step N of M")شريط التقدم يوضح موضعك ("الخطوة N من M")
• Check the box "I have reviewed the onboarding material above"أشّر على "لقد راجعت المحتوى أعلاه"
• Click "Next Step" to advance (or "Previous" to go back)انقر "الخطوة التالية" للمتابعة (أو "السابق" للرجوع)

Step 4 — Acknowledge checklist itemsالخطوة 4 — إقرار بنود القائمة

• You'll see a list of items grouped by category (policies, training docs)سترى قائمة بالبنود مجمّعة حسب الفئة (سياسات، تدريب)
• Items marked "Required" must be acknowledged before you can activate your accountالبنود المؤشّرة بـ "إلزامي" يجب الإقرار بها قبل تفعيل حسابك
• Click each item → a signature modal opensانقر على كل بند → يفتح نافذة التوقيع
• Type your full name as your digital signatureاكتب اسمك الكامل كتوقيع رقمي
• Click "Acknowledge" — the item turns green ✓انقر "إقرار" — يتحول البند إلى أخضر ✓

Step 5 — Set up your accountالخطوة 5 — إعداد الحساب

Click "Activate Account" to finalize.انقر "تفعيل الحساب" للإنهاء.

Step 6 — Completeالخطوة 6 — اكتمال

You'll see a green success screen: "Congratulations!". Click "Start Exploring" to enter PX360. ستظهر شاشة نجاح خضراء: "تهانينا!". انقر "ابدأ الاستكشاف" للدخول إلى نظام PX360.

11. Hospital Selectionاختيار المستشفى

As a PX Admin, you manage multiple hospitals. PX360 asks you to select a hospital before you can access anything. You can switch hospitals at any time from the sidebar. كمدير PX، تدير عدة مستشفيات. يطلب منك نظام PX360 اختيار مستشفى قبل الوصول إلى أي شيء. يمكنك التبديل بين المستشفيات في أي وقت من القائمة الجانبية.

First-time selectionالاختيار الأول

1. After login, you're redirected to /core/select-hospital/بعد الدخول، يتم تحويلك إلى /core/select-hospital/
2. You'll see a grid of hospital cards — each showing the name, city, and a building iconسترى شبكة من بطاقات المستشفيات — كل منها يعرض الاسم، المدينة، وأيقونة مبنى
3. Click a hospital card — it highlights with a blue border and a check mark ✓انقر على بطاقة مستشفى — تتميز بحدود زرقاء وعلامة صح ✓
4. Click "Continue to Dashboard"انقر "المتابعة إلى لوحة التحكم"

Switching hospitalsتبديل المستشفى

• At the bottom of the sidebar, use the Hospital dropdownأسفل القائمة الجانبية، استخدم القائمة المنسدلة المستشفى
• Select a different hospital — the page reloads with data scoped to the new hospitalاختر مستشفى آخر — تُعاد تحميل الصفحة بالبيانات الخاصة بالمستشفى الجديد

12. Navigation & Sidebarالتنقل والقائمة الجانبية

The sidebar on the left is your main navigation. It's role-aware — different roles see different menu items. The sidebar collapses to icons by default and expands when you hover. القائمة الجانبية على اليسار هي تنقلك الرئيسي. إنها حساسة للدور — أدوار مختلفة ترى عناصر مختلفة. تنطوي القائمة على أيقونات افتراضياً وتتوسع عند التمرير عليها.

Sidebar behaviorسلوك القائمة الجانبية

• Collapsed by default — shows only icons (narrow, 5rem wide)منطوية افتراضياً — تعرض الأيقونات فقط (ضيقة)
• Hover to expand — move your mouse over the sidebar to see labelsمرر للتوسع — حرك الماوس فوق القائمة لرؤية الأسماء
• Pin Sidebar — click the pin icon to keep it expanded permanentlyتثبيت القائمة — انقر أيقونة الدبوس لإبقائها متوسعة دائماً
• RTL — in Arabic mode, the sidebar moves to the right sideRTL — في الوضع العربي، تنتقل القائمة إلى الجانب الأيمن

Top barالشريط العلوي

Menu structure by sectionهيكل القائمة حسب القسم

Dashboardلوحة التحكم

• Dashboard — analytics overview (admins, management, executives, directors)لوحة التحكم — نظرة تحليلية (الإداريون، الإدارة، التنفيذيون، المدراء)
• My Tasks — your assigned tasks (everyone)مهامي — مهامك المسندة (الجميع)
• Command Center — real-time operations consoleمركز القيادة — وحدة عمليات لحظية

Core Feedbackالملاحظات الأساسية

• Complaints, Inquiries, Observations, Suggestions, Appreciationالشكاوى، الاستفسارات، الملاحظات، الاقتراحات، الشكر

People & Recordsالأشخاص والسجلات

• Patients — patient directoryالمرضى — دليل المرضى
• Physicians — dashboard, list, leaderboard, ratingsالأطباء — لوحة، قائمة، ترتيب، تقييمات
• Staff — all staff, hierarchy, activity log (PX Admin)الموظفون — جميع الموظفين، الهيكل، سجل النشاط
• Departments — department directory (or My Department for dept managers/champions)الأقسام — دليل الأقسام (أو قسمي لمديري الأقسام والأبطال)

Quality & Improvementالجودة والتحسين

• QI Projects — quality improvement projectsمشاريع الجودة
• Surveys — survey list, templates, create, mappingالاستبيانات — قائمة، قوالب، إنشاء، ربط
• Standards — compliance dashboard, standards list, sources, categoriesالمعايير — لوحة الامتثال، قائمة المعايير، المصادر، الفئات

Sources & Outreachالمصادر والتواصل

• PX Sources — all sources, government tickets, communication requestsمصادر PX — جميع المصادر، التذاكر الحكومية، طلبات التواصل
• Social Media (PX Admin only)التواصل الاجتماعي (مدير PX فقط)

Reportsالتقارير

• Create Report, Saved Reports, KPI Reports, Census, Inquiry/Observation/Complaint Reports, Comments Analysisإنشاء تقرير، التقارير المحفوظة، تقارير KPI، الإحصاء، تقارير الاستفسارات/الملاحظات/الشكاوى، تحليل التعليقات

Reference & Configالمراجع والإعدادات

• References — document repository (dashboard, search, upload, folders)المراجع — مستودع المستندات
• Acknowledgements — digital document signing (red badge = pending items)الإقرارات — توقيع المستندات رقمياً (شارة حمراء = بنود معلّقة)
• Settings — system configuration (PX Admin / Hospital Admin)الإعدادات — تكوين النظام (مدير PX / مدير المستشفى)
• Deleted Items — soft-deleted records (PX Admin / Hospital Admin)العناصر المحذوفة — السجلات المحذوفة مؤقتاً

Champion (Department Respondent) — minimal viewالبطل (مجيب القسم) — عرض مبسط

If you are a Champion and not also an admin/manager, your sidebar shows only: إذا كنت بطلاً وست لست أيضاً إدارياً/مديراً، تعرض قائمتك الجانبية فقط:

• My Tasksمهامي
• My Department — your department's detail pageقسمي — صفحة تفاصيل قسمك

Everything else is hidden. Champions primarily interact via token-based response forms sent by email (no full login needed for those). كل شيء آخر مخفي. يتفاعل الأبطال أساساً عبر نماذج الرد المستندة إلى الرمز المرسلة بالبريد (لا حاجة لتسجيل دخول كامل لها).

13. Language Switchingتبديل اللغة

PX360 is fully bilingual — English and Arabic. You can switch the language at any time. The change takes effect immediately. نظام PX360 ثنائي اللغة بالكامل — الإنجليزية والعربية. يمكنك تبديل اللغة في أي وقت. يسري التغيير فوراً.

How to switchكيفية التبديل

• Click the language buttons in the top bar (top-right corner)انقر أزرار اللغة في الشريط العلوي (الزاوية اليمنى)
• Or use the language buttons at the bottom of the sidebarأو استخدم أزرار اللغة في أسفل القائمة الجانبية
• Flags: 🇬🇧 English / 🇸🇦 Arabicالأعلام: 🇬🇧 إنجليزي / 🇸🇦 عربي

What changesما الذي يتغير

14. Dashboard & Command Centerلوحة التحكم ومركز القيادة

The Command Center (/) is your real-time operations console. It follows the "5-Second Rule" — critical signals are immediately visible.مركز القيادة (/) هو وحدة العمليات اللحظية. يتبع "قاعدة الـ 5 ثوانٍ" — الإشارات الحرجة ظاهرة فوراً.

What you seeما تراه

• Red Alert Banner — appears only when items need immediate action (critical complaints, overdue items, escalated actions)تنبيه أحمر — يظهر فقط عندما تحتاج عناصر إلى إجراء فوري
• 5 Core Module Cards — Complaints, Survey Insights, PX Actions, Inquiries, Observations (each with counts, trends, and click-through)5 بطاقات للوحدات الأساسية — الشكاوى، الاستبيانات، الإجراءات، الاستفسارات، الملاحظات
• Charts — Complaints Trend (day/week/month), NPS Score, Severity Distribution, Actions Pipelineرسوم بيانية — اتجاه الشكاوى، درجة NPS، توزيع الخطورة، خط أنابيب الإجراءات
• Live Feed — latest high-severity complaints and escalated actionsتغذية حية — أحدث الشكاوى عالية الخطورة والإجراءات المصعّدة
• Auto-refresh — updates every 60 seconds; manual "Refresh Now" button availableتحديث تلقائي — كل 60 ثانية؛ زر "تحديث الآن" متاح

15. Complaintsالشكاوى

The Complaints module is the core of PX360. It manages the full complaint lifecycle from intake to resolution, with AI-assisted classification, SLA tracking, department routing, and escalation.وحدة الشكاوى هي جوهر نظام PX360. تدير دورة حياة الشكوى الكاملة من الاستلام إلى الحل، مع تصنيف بالذكاء الاصطناعي، وتتبع SLA، وتوجيه الأقسام، والتصعيد.

List pageصفحة القائمة

URL: /complaints/. Shows stat cards (Total, Resolved, Pending, Overdue), quick filter pills (All/Pending/In Progress/Resolved), advanced filters (Priority, Department, Severity, Date range), and search by reference, patient name, or MRN.الرابط: /complaints/. يعرض بطاقات إحصائية ومرشحات سريعة ومتقدمة وبحث بالرقم المرجعي أو اسم المريض.

Creating a complaint (internal)إنشاء شكوى (داخلي)

1. Click "New Case" on the list pageانقر "حالة جديدة"
2. Fill the form — see fields belowاملأ النموذج — انظر الحقول أدناه
3. Submit — AI auto-classifies (severity, priority, category) and a reference CMP- is generatedأرسل — يصنّف الذكاء الاصطناعي تلقائياً ويُنشأ رقم CMP-

The complaint lifecycle (stepper)دورة حياة الشكوى

1. Created — complaint is in the system (status: Open)أُنشئت — الشكوى في النظام (الحالة: مفتوحة)
2. Activate — click "Activate" to self-assign and move to In Progressتفعيل — انقر "تفعيل" لإسنادها لنفسك والانتقال إلى "قيد التنفيذ"
3. Review Taxonomy — edit the AI classification (Domain/Category/Subcategory/Classification), then click "Confirm"مراجعة التصنيف — عدّل تصنيف الذكاء الاصطناعي ثم انقر "تأكيد"
4. Send to Department — open the Send modal, pick department + optional staff, add a note. The department champion and manager are notified.إرسال للقسم — افتح نافذة الإرسال، اختر القسم والموظف، أضف ملاحظة. يتم إشعار بطل القسم والمدير.
5. Department Response — the champion responds via a token-based email link or the staff uses "Submit Response"رد القسم — يرد البطل عبر رابط البريد أو يستخدم الموظف "تقديم الرد"
6. Resolve — generate a resolution (AI-assisted EN/AR), then "Mark as Resolved"الحل — أنشئ الحل (بمساعدة الذكاء الاصطناعي) ثم "تم الحل"
7. Close — close the complaint; triggers a satisfaction survey to the patientإغلاق — أغلق الشكوى؛ يطلق استبيان الرضا للمريض

Detail page actionsإجراءات صفحة التفاصيل

16. Inquiriesالاستفسارات

Inquiries are lighter than complaints — they handle questions and information requests. The lifecycle is simpler.الاستفسارات أبسط من الشكاوى — تتعامل مع الأسئلة وطلبات المعلومات. دورة الحياة أبسط.

List pageصفحة القائمة

URL: /inquiries/. Stats: Total, Resolved, In Progress, Overdue. Filters: Search, Status, Category.الرابط: /inquiries/. إحصائيات ومرشحات.

Creating an inquiryإنشاء استفسار

Click "New Inquiry". Fields: Hospital, Location Type, Contact Name*, Contact Phone, Contact Email, Category*, Priority, Subject*, Message*. Optional Outgoing Inquiry toggle to set an Outgoing Department.انقر "استفسار جديد". الحقول مماثلة للشكاوى مع حقل الموضوع.

Detail page actionsإجراءات صفحة التفاصيل

17. Observationsالملاحظات

Observations are safety or quality reports. They can come from the public (anonymous) or be created internally. The key staff action is triage.الملاحظات هي تقارير Safety أو جودة. قد تأتي من الجمهور (مجهولة) أو تُنشأ داخلياً. الإجراء الرئيسي هو الفرز.

List pageصفحة القائمة

URL: /observations/. Filters: Search, Status, Severity, Category, Department, Assigned, Date range. Sortable by date or severity.الرابط: /observations/. مرشحات وبحث وفرز.

Creating an observation (internal)إنشاء ملاحظة (داخلي)

Click "New Observation". Fields: Hospital, Location Type, Area, Department, Assign To, When did this occur?, Patient File Number, Description*.انقر "ملاحظة جديدة". الحقول: المستشفى، الموقع، القسم، الوصف.

Detail page actionsإجراءات صفحة التفاصيل

18. Feedback & Suggestionsالملاحظات والاقتراحات

The Feedback module handles compliments, suggestions, and general feedback. It includes a comment classification pipeline for imported patient comments.وحدة الملاحظات تتعامل مع الشكر والاقتراحات والملاحظات العامة. تتضمن خط أنابيب لتصنيف تعليقات المرضى المستوردة.

List pageصفحة القائمة

URL: /suggestions/. Extensive filters: type, status, category, sentiment, priority, hospital, department, rating, date range. Stats include sentiment breakdown and average rating.الرابط: /suggestions/. مرشحات شاملة وإحصائيات المشاعر والتقييم.

Status lifecycleدورة الحياة

Submitted → Reviewed → Acknowledged → Closed (with Reopened from Closed).مُرسل ← مراجَع ← مُقرّ ← مغلق.

Detail page actionsإجراءات صفحة التفاصيل

• Assign — pick a user + noteإسناد — اختر مستخدماً وملاحظة
• Change Status — dropdown with transition enforcementتغيير الحالة — قائمة منسدلة
• Send to Department — routes to dept champion/managerإرسال للقسم — يوجّه للقسم
• Add Response — type + internal flagإضافة رد — اكتب + علامة داخلية
• Create PX Action — from AI-suggested actions or manuallyإنشاء إجراء — من اقتراحات الذكاء الاصطناعي أو يدوياً
• Toggle Featured / Follow-up — admin flagsتمييز / متابعة — علامات إدارية

Comment classification pipelineخط تصنيف التعليقات

Admins can import patient comments from IT data (CSV), classify them (Hospital/Medical/Nursing/ER/Support), assign sub-categories (Pharmacy, LAB, Food, etc.), track sentiment, and create department action plans with export.يمكن للإداريين استيراد تعليقات المرضى وتصنيفها وإنشاء خطط عمل للأقسام مع التصدير.

19. Appreciationالتقدير

The Appreciation module recognizes staff. Appreciations enter as Draft via the public form, then staff activate, AI-analyze, and send them to the recognized person/department.وحدة التقدير تكرّم الموظفين. تدخل كـ مسودة من النموذج العام، ثم يفعّلها الموظفون ويرسلونها.

Lifecycleدورة الحياة

Draft → Activated → AI Analyzed → Sent → Acknowledgedمسودة ← مفعّل ← محلل ← مُرسل ← مُقرّ

Staff workflowسير عمل الموظف

1. Activate — pick Staff Member, Department, Category → "Activate & Analyze" (AI generates summary EN/AR, themes, tone)تفعيل — اختر الموظف والقسم ← "تفعيل وتحليل"
2. Send to Department — pick recipient (person or department); emails/SMS the champion + managerإرسال للقسم — اختر المستلم؛ يتم إشعار البطل والمدير
3. Acknowledge — only the assigned recipient can acknowledgeإقرار — فقط المستلم المعين يمكنه الإقرار

Gamificationتحفيز

• Leaderboard — ranks by received_count (monthly aggregates). Filters: year, month, hospital, department.المتصدرون — ترتيب حسب عدد الاستلام. مرشحات.
• My Badges — earned badges + progress toward unearned onesأوسمتي — الأوسمة المكتسبة والتقدم
• Categories & Badges admin — admins manage categories and badge criteriaإدارة الفئات والأوسمة — يدير الإداريون

20. Surveysالاستبيانات

The Surveys module lets you build survey templates, send them to patients (manual, CSV, or HIS import), and analyze results including AI sentiment analysis on comments.وحدة الاستبيانات تتيح بناء قوالب الاستبيان وإرسالها للمرضى وتحليل النتائج.

Template builderمنشئ القوالب

URL: /surveys/templates/. Click "Create" to build a new template.الرابط: /surveys/templates/. انقر "إنشاء" لبناء قالب.

• Add/Remove questions with drag-to-reorder (SortableJS)إضافة/حذف الأسئلة مع سحب لإعادة الترتيب
• Event Type binding — link questions to specific HIS visit eventsربط بنوع الحدث — اربط الأسئلة بأحداث الزيارة

Sending surveysإرسال الاستبيانات

Analyticsالتحليلات

• Engagement Dashboard — open rate, completion rate, abandonment rate, avg timeلوحة التفاعل — معدل الفتح، الإكمال، التخلي
• Comments Analysis — AI sentiment on free-text comments, charts by patient typeتحليل التعليقات — مشاعر الذكاء الاصطناعي
• Enhanced Reports — per-survey-type reports with charts and recommendationsتقارير محسّنة — تقارير لكل نوع استبيان

21. Reportsالتقارير

The Reports module is a custom report builder. Pick a data source, apply filters, select columns, generate, and export.وحدة التقارير هي منشئ تقارير مخصص. اختر مصدر البيانات، طبّق المرشحات، اختر الأعمدة، أنشئ، وصدّر.

Report builderمنشئ التقارير

URL: /reports/. Left panel = configuration, right panel = live preview.الرابط: /reports/. اللوحة اليسرى = التكوين، اليمنى = المعاينة.

1. Data Source — choose: Complaints, Inquiries, Observations, PX Actions, Surveys, Physicians, Staff, Departments, Suggestions, Appreciations, Patientsمصدر البيانات — اختر من القائمة
2. Date Range — Last 7/30/90 days, Year to Date, or Customالنطاق الزمني
3. Filters — Department, Statusالمرشحات
4. Columns — checkboxes (first 8 selected by default); Select All / Clearالأعمدة
5. Generate Report — interactive table with search, sort, column toggle, printإنشاء التقرير
6. Save Report — name it, optionally share with hospitalحفظ التقرير

Export formatsصيغ التصدير

From a saved report's detail page: CSV, Excel (styled), PDF, or View Online (HTML). Also: Copy-to-clipboard and Print.من صفحة التقرير المحفوظ: CSV، Excel، PDF، أو عرض. أيضاً: نسخ وطباعة.

Report templatesقوالب التقارير

Predefined gallery: Complaints by Department/Journey/Trends/SLA, Inquiries by Dept/Response Time/Source, Surveys Satisfaction/Response Rate/Negative, and more.معرض قوالب جاهزة للشكاوى والاستفسارات والاستبيانات.

KPI Reportsتقارير KPI

URL: /analytics/kpi-reports/. Separate from the builder — generates structured KPI reports with AI analysis, PDF export, and regeneration.الرابط: /analytics/kpi-reports/. منفصل عن المنشئ — يولّد تقارير KPI منظمة.

22. QI Projects & PX Actionsمشاريع الجودة والإجراءات

QI Projectsمشاريع الجودة

URL: /projects/. Quality Improvement initiatives using the PDCA (Plan-Do-Check-Act) cycle. Tasks organized into kanban-style phase columns.الرابط: /projects/. مبادرات تحسين الجودة باستخدام دورة PDCA.

• Create — name, description, hospital, departments, project lead*, team members, datesإنشاء — الاسم، الوصف، المستشفى، الأقسام، القائد، الفريق
• Detail page — kanban board with PDCA (4) or FOCUS (5) columns; HTMX task add/toggle/deleteصفحة التفاصيل — لوحة كانبان مع مهام
• My Tasks — /projects/my-tasks/ shows your assigned tasks across all projectsمهامي — مهامك في جميع المشاريع
• Save as Template — reuse project structureحفظ كقالب

PX Actionsإجراءات PX

URL: /actions/. Tracked, SLA-bound improvement tasks. Auto-created from negative surveys, complaints, or low call-center ratings — or created manually.الرابط: /actions/. مهام تحسين مرتبطة بـ SLA. تُنشأ تلقائياً أو يدوياً.

Status: Open → In Progress → Pending Approval → Approved → Closed (or Cancelled).الحالة: مفتوح ← قيد التنفيذ ← بانتظار الموافقة ← معتمد ← مغلق.

23. Root Cause Analysis (RCA)تحليل السبب الجذري

URL: /rca/. Formally investigate a complaint, inquiry, observation, or feedback — identify root causes and track corrective actions.الرابط: /rca/. تحقيق رسمي لتحديد الأسباب الجذرية وتتبع الإجراءات التصحيحية.

Status workflowدورة الحالة

Draft → In Progress → Review → Approved → Closedمسودة ← قيد التنفيذ ← مراجعة ← معتمد ← مغلق

Creating an RCAإنشاء تحليل

1. From any complaint/inquiry/observation detail page, click "Initiate RCA"من صفحة التفاصيل، انقر "بدء تحليل"
2. Or go to /rca/create/ and link manually via ?related_model=complaint&related_id=...أو اذهب إلى /rca/create/ واربط يدوياً

Key componentsالمكونات الرئيسية

• Root Causes — description, category (Process/People/Equipment/Communication/Policy/Environment/Technology/Other), likelihood (1-5), impact (1-5); risk score = L × Iالأسباب الجذرية — الوصف، الفئة، الاحتمالية، التأثير
• Corrective Actions — description, type (Preventive/Corrective/Immediate/Long-term), responsible person, target date, status, effectivenessالإجراءات التصحيحية — الوصف، النوع، المسؤول، التاريخ المستهدف
• Attachments — supporting evidence documentsالمرفقات
• Notes — internal notesالملاحظات

24. Call Centerمركز الاتصال

URL: /callcenter/interactions/. Log call interactions with patients and capture satisfaction ratings (1–5). Ratings below 3 auto-flag as low and trigger a PX Action.الرابط: /callcenter/interactions/. تسجيل تفاعلات الاتصال وتقييمات الرضا.

Call typesأنواع المكالمات

Inquiry, Complaint, Appointment, Follow-up, Feedback, Other.استفسار، شكوى، موعد، متابعة، ملاحظة، أخرى.

CSV importاستيراد CSV

URL: /callcenter/records/import/. Upload call recording metadata (Media ID, Call Start/End, Department, Length, etc.). Download the template from /callcenter/records/export-template/.الرابط: /callcenter/records/import/. ارفع بيانات التسجيلات. حمل القالب من /callcenter/records/export-template/.

25. Standardsالمعايير

URL: /standards/. Track accreditation compliance (CBAHI, JCI, MOH, CHI). Register standards, map them to departments, assess compliance, and attach evidence.الرابط: /standards/. تتبع امتثال الاعتماد. سجّل المعايير، اربطها بالأقسام، قيّم الامتثال.

What you can doما يمكنك فعله

• Dashboard — counts (Met, Partially Met, Not Met, Not Assessed) per hospitalلوحة التحكم
• Browse by department — standards grouped by source → category, with compliance statusتصفح حسب القسم
• Assess compliance — set status (Met / Partially Met / Not Met / N/A), add corrective action, attach evidenceتقييم الامتثال
• Search — filter by code, title, source, category, statusبحث
• Manage taxonomy — sources, categories, activity types (admin)إدارة التصنيف

26. Referencesالمراجع

URL: /references/. Bilingual document repository with hierarchical folders, role-based access, versioning, and full-text search.الرابط: /references/. مستودع مستندات ثنائي اللغة بمجلدات هرمية وإصدارات وبحث.

• Dashboard — root folders, recent documents, countsلوحة التحكم
• Folders — nested, with icon, color, access roles, orderالمجلدات
• Upload document — title (EN/AR), file (PDF/Word/Excel/images, max 100 MB), description, tags, access roles, "new version" checkboxرفع مستند
• Search — by text, folder, file type, tagsبحث

27. Acknowledgementsالإقرارات

URL: /accounts/acknowledgements/my-acknowledgements/. Sign policy and training documents digitally. A red badge on the sidebar shows pending items.الرابط: /accounts/acknowledgements/my-acknowledgements/. وقّع المستندات رقمياً. شارة حمراء تظهر البنود المعلّقة.

How to signكيفية التوقيع

1. Open the acknowledgement from your listافتح الإقرار من قائمتك
2. Review the attached PDF documentراجع ملف PDF المرفق
3. Type your full name as signatureاكتب اسمك الكامل كتوقيع
4. Type your Employee IDاكتب رقمك الوظيفي
5. Check the "I have read and understood..." confirmation boxأشّر على "لقد قرأت وفهمت..."
6. Submit — your signature, timestamp, and IP are recorded for auditأرسل — يتم تسجيل توقيعك والوقت و IP

28. PX Sourcesمصادر PX

URL: /px-sources/. Manage feedback sources (government portals, partners). Source Users get a simplified dashboard to log complaints/inquiries/observations on behalf of external channels.الرابط: /px-sources/. إدارة مصادر الملاحظات. يحصل مستخدمو المصدر على لوحة مبسطة.

Communication Requestsطلبات التواصل

When a Source User needs the PX team to contact a patient, they create a Communication Request (patient name, phone, MRN, reason, message). Staff resolve it (Pending → Contacted → Resolved → Closed) and can link it to a real Complaint/Inquiry/Observation.عندما يحتاج مستخدم المصدر لتواصل فريق PX مع مريض، ينشئ طلب تواصل. يحله الموظفون ويربطونه بسجل فعلي.

29. Physiciansالأطباء

URL: /physicians/. Track monthly physician rating performance from surveys and HIS/CSV imports.الرابط: /physicians/. تتبع أداء تقييمات الأطباء الشهرية.

• Directory — browse physicians by hospital/department/specializationالدليل
• Ratings Dashboard — stats, 6-month trend, distribution, department comparison, sentimentلوحة التقييمات
• Leaderboard — ranked by average rating for selected periodالمتصدرون
• Import Ratings (CSV) — upload Doctor Rating Report (auto-detects columns, skip header rows)استيراد التقييمات
• Fetch Ratings (HIS API) — async job fetches from HIS by date rangeجلب التقييمات

30. Staff & Departmentsالموظفون والأقسام

URL: /organizations/staff/ and /organizations/departments/. Browse staff and department directories.الروابط: /organizations/staff/ و /organizations/departments/.

• Staff List — search, filter by hospital/department/role; shows each person's department, role, and activityقائمة الموظفين
• Staff Hierarchy — visual org chart (D3.js) showing reporting linesهيكل الموظفين
• Staff Activity Log (PX Admin only) — audit trail of all user actionsسجل النشاط
• Department Detail — shows department info, staff, linked complaints/actions, champion assignmentsتفاصيل القسم
• Patients — /organizations/patients/ patient directoryالمرضى

31. Settings & Deleted Itemsالإعدادات والعناصر المحذوفة

URL: /config/. System configuration console.الرابط: /config/. وحدة تكوين النظام.

Settingsالإعدادات

• SLA Configurations — per-hospital/department SLA overrides for PX Actions (critical/high/medium/low hours, reminder, auto-escalation)تكوين SLA
• Routing Rules — auto-routing conditions (source_type, category, severity) → target (assign_to_role/user/department)قواعد التوجيه
• Hospital Users — create/edit/activate/deactivate users; reset password (sends link)مستخدمو المستشفى

Deleted Items (Recycle Bin)العناصر المحذوفة

URL: /config/deleted/ (PX Admin only). Browse soft-deleted complaints, inquiries, observations, and appreciations. Restore as needed.الرابط: /config/deleted/. تصفح العناصر المحذوفة مؤقتاً واستعدها.

Personal settingsالإعدادات الشخصية

URL: /accounts/settings/. 5 tabs: Profile (name, phone, language, bio, avatar), Notifications (email/SMS toggles, channels), Security (change password), Account (read-only info), Activity (login/action log).الرابط: /accounts/settings/. 5 تبويبات: الملف الشخصي، الإشعارات، الأمان، الحساب، النشاط.