هذه الصفحة مسودة أولى للترجمة كتبها الذكاء الاصطناعي، ولم يراجعها بعد متحدث يتقن العربية.
الدليل التعليمي
يشرح هذا الدليل طريقة تشغيل النظام على جهاز محلي. ويتطلب استخدام الطرفية، لكنه لا يتطلب معرفة بلغة Rust أو Svelte.
هذا الإعداد مخصص للتقييم فقط. لا تستخدم بيانات مرضى حقيقية، فهو يستخدم كلمات مرور اختبارية معروفة علنًا.
الخطوة 1: تثبيت الأدوات
الأدوات التالية مطلوبة:
- Rust، لبناء واجهة برمجة التطبيقات. ويختار المشروع الإصدار المناسب لك.
- Node 26 مع pnpm، لتشغيل واجهة الويب.
- Podman، لتشغيل قاعدة البيانات وخدمة تسجيل الدخول.
الخطوة 2: الحصول على الشيفرة
افتح طرفية، ونزّل المشروع، ثم انتقل إلى مجلده:
git clone https://github.com/patient-administration-system/patient-administration-system.git
cd patient-administration-systemالخطوة 3: تشغيل قاعدة البيانات وخدمة تسجيل الدخول
podman compose -f podman/compose.yml up -dإذا كان أحد المنافذ مستخدمًا بالفعل، فاختر منافذ أخرى كما هو موضح، وغيّر أرقام المنافذ المقابلة في الخطوات اللاحقة:
PAS_PG_PORT=5442 PAS_KEYCLOAK_PORT=8190 podman compose -f podman/compose.yml up -dالخطوة 4: إعداد قاعدة البيانات
تُنشئ هذه الخطوة الجداول، وتضيف منشأة تجريبية واحدة وجناحًا واحدًا وغرفة واحدة وثلاثة أسرّة. ويؤدي التشغيل الأول إلى تنزيل التبعيات وتصريفها، وقد يستغرق ذلك بعض الوقت.
export DATABASE_URL=postgres://pas:pas_dev_password@localhost:5432/pas
cargo run -p patient-administration-system-migrations --bin pas-migrate -- up
cargo run -p patient-administration-system --bin pas-seedالخطوة 5: تشغيل خدمة الرموز
افتح طرفية ثانية في المجلد نفسه، واترك هذا الأمر قيد التشغيل:
sh scripts/dev-auth.shالخطوة 6: تشغيل واجهة برمجة التطبيقات
شغّل ما يلي في الطرفية الأولى:
PAS_PASETO_KEYS_URL=http://127.0.0.1:8195/keys.json PAS_REQUIRE_AUTH=true \
cargo run -p patient-administration-system --bin patient-administration-systemبعد بدء التشغيل، افتح http://localhost:8080/api/health في متصفح للتأكد من أنها تعمل. ويتطلب Swagger UI على /swagger-ui/ رمزًا في هذا الوضع، ولذلك يُرجع 401.
الخطوة 7: تشغيل واجهة الويب
افتح طرفية ثالثة في مجلد المشروع:
cd patient-administration-system-ui-with-svelte
cp .env.example .env
pnpm install && pnpm run devإذا اخترت منفذًا آخر لـ Keycloak في الخطوة 3، فغيّره أيضًا في OIDC_ISSUER داخل .env.
الخطوة 8: تسجيل الدخول
افتح http://localhost:5173 وسجّل الدخول باسم أحد المستخدمين الاختباريين:
| اسم المستخدم | كلمة المرور | الغرض |
|---|---|---|
admin |
admin |
عرض الموظفين: الجدول والمواعيد وقوائم الانتظار |
patient |
patient |
عرض المريض: المواعيد والرسائل |
يُطلب من المستخدم admin أيضًا إدخال رمز يُستخدم مرة واحدة، كما يُطلب من الموظفين. أضف مفتاح التطوير JBSWY3DPEHPK3PXP إلى تطبيق مصادقة، ثم أدخل الرمز الذي يعرضه.
ستكون القوائم فارغة. لا تحتوي البيانات التجريبية على أشخاص، لأن المرضى والموظفين محفوظون في person-service وworker-service، وهما مشروعان منفصلان.
الخطوة 9: الإيقاف
اضغط Ctrl وC في كل طرفية لإيقاف البرامج، ثم أوقف الخدمات المساندة:
podman compose -f podman/compose.yml down