واجهة برمجة التطبيقات: الاختبار: الأدوات: الويب: تطبيق الويب:
OpenMRS هو نظام سجلات طبية يعتمد على المريض ويركز على منح مقدمي الخدمة نظام سجلات طبية إلكتروني مجاني قابل للتخصيص (EMR).
تتمثل مهمة OpenMRS في تحسين تقديم الرعاية الصحية في البيئات المحدودة الموارد من خلال تنسيق مجتمع عالمي يقوم بإنشاء منصة نظام سجلات طبية قوية وقابلة للتطوير وموجهة من قبل المستخدم ومفتوحة المصدر.
OpenMRS هو تطبيق Java ولهذا السبب تحتاج إلى تثبيت Java JDK.
إذا كنت ترغب في إنشاء الفرع الرئيسي، فستحتاج إلى Java JDK بالإصدار 8 على الأقل.
قم بتثبيت أداة البناء Maven.
يجب عليك التأكد من أن Maven يستخدم Java JDK اللازم للفرع الذي ترغب في إنشائه.
للقيام بذلك تنفيذ
mvn -version
والذي سيخبرك بالإصدار الذي يستخدمه Maven. ارجع إلى مستندات Maven إذا كنت بحاجة إلى تكوين Maven.
قم بتثبيت أداة التحكم في الإصدار git واستنساخ هذا المستودع باستخدامها
git clone https://github.com/openmrs/openmrs-core.git
بعد أن اهتممت بالمتطلبات الأساسية
قم بتنفيذ ما يلي
cd openmrs-core
mvn clean package
سيؤدي هذا إلى إنشاء تطبيق OpenMRS في webapp/target/openmrs.war
والذي سيتعين عليك نشره في خادم تطبيقات مثل Tomcat أو jetty على سبيل المثال.
لأغراض التطوير، يمكنك ببساطة نشر openmrs.war
في رصيف خادم التطبيق عبر
cd openmrs-core/webapp
mvn jetty:run
إذا سارت الأمور على ما يرام (تحقق من مخرجات وحدة التحكم) يمكنك الوصول إلى تطبيق OpenMRS على localhost:8080/openmrs
.
ارجع إلى البدء كمطور - Maven للحصول على مزيد من المعلومات حول أوامر Maven المفيدة وخيارات البناء.
لا تزال عمليات إنشاء Docker قيد التقدم. نحن نقدر أي ردود فعل والتحسينات في هذه العملية.
الشرط الوحيد المطلوب هو Docker.
من أجل بناء نسخة التطوير، قم بتشغيل:
docker-compose build
يستدعي mvn install
بشكل افتراضي. إذا كنت ترغب في تخصيص وسيطات بناء mvn، فيمكنك القيام بذلك عن طريق تشغيل:
docker-compose build --build-arg MVN_ARGS= ' install -DskipTests '
من الممكن أيضًا استخدام صورة المطور المضمنة لتشغيل الرصيف:
docker-compose up
من أجل بناء نسخة الإنتاج، قم بتشغيل:
docker-compose -f docker-compose.yml build
يقوم أولاً ببناء صورة المطور ثم صورة باستخدام Tomcat وopenmrs.war. ليس لديها تبعيات التطوير.
يمكن تشغيل نسخة الإنتاج باستخدام:
docker-compose -f docker-compose.yml up
إذا كنت تريد تصحيح الأخطاء، فأنت بحاجة إلى تشغيل إصدار تطوير وتوصيل مصحح الأخطاء بالمنفذ 8000، والذي يتم كشفه افتراضيًا.
لسوء الحظ، في هذه المرحلة، تتطلب أي تغييرات في التعليمات البرمجية إعادة التشغيل الكامل وإعادة بناء حاوية عامل الإرساء. لتسريع العملية، يرجى استخدام:
docker-compose build --build-arg MVN_ARGS= ' install -DskipTests '
docker-compose up
نحن نعمل على توفير الدعم لميزة إعادة التحميل التلقائي لـ Spring Boot، والتي سيتم توثيقها هنا بمجرد أن تصبح جاهزة.
من الممكن أيضًا نشر صورة تم إنشاؤها بواسطة CI لدينا، والتي يتم نشرها على https://hub.docker.com/r/openmrs/openmrs-core
يمكنك تشغيل أي علامة متاحة باستخدام:
TAG=nightly docker-compose -f docker-compose.yml up
من الممكن أيضًا تشغيل نسخة تطويرية من الصورة باستخدام:
TAG=dev docker-compose up
تحتوي جميع إصدارات التطوير على لاحقة dev. لاحقة ذاكرة التخزين المؤقت مخصصة للاستخدام من قبل CI لدينا.
يتم إعداد شجرة المشروع على النحو التالي:
واجهة برمجة التطبيقات/ | ملفات Java والموارد لإنشاء ملف Java api jar. |
أدوات/ | كود التعريف المستخدم أثناء التجميع والاختبار. لا يدخل في أي ثنائي تم إصداره (مثل doclets). |
الويب/ | ملفات Java والموارد المستخدمة في ملف webapp/war. |
تطبيق الويب/ | الملفات المستخدمة في بناء ملف الحرب (يحتوي على ملفات JSP في الإصدارات الأقدم). |
pom.xml | الملف الرئيسي المخضرم المستخدم لبناء وحزم OpenMRS. |
للتطوير السريع للوحدات وكود منصة OpenMRS، قم بمراجعة SDK الرائع على
https://wiki.openmrs.org/display/docs/OpenMRS+SDK
يحتوي OpenMRS على بنية معيارية تسمح للمطورين بتوسيع وظائف OpenMRS الأساسية عن طريق إنشاء وحدات يمكن إضافتها أو إزالتها بسهولة لتلبية احتياجات تنفيذ معين.
قبل إنشاء الوحدة النمطية الخاصة بك، انتقل إلى مستودع وحدات OpenMRS وتأكد من وجود وحدة بالفعل لحالة الاستخدام المحددة الخاصة بك. إذا كان الأمر كذلك، قم بنشره وجربه، وإذا كانت هناك وظيفة مفقودة، انضم إلى مطوري الوحدة لإضافة ميزة.
إذا لم تجد ما كنت تبحث عنه، فارجع إلى الوحدة - wiki لمعرفة كيفية إنشاء وحدة نمطية جديدة.
إذا كنت تريد المساهمة يرجى الرجوع إلى هذه الموارد
إذا كنت تبحث عن أدلة تفصيلية حول كيفية تثبيت OpenMRS وتكوينه والمساهمة فيه وتوسيع نطاقه، فقم بزيارة OpenMRS
http://wiki.openmrs.org
إذا كنت تبحث عن مزيد من المعلومات بخصوص OpenMRS كفحص مؤسسي
http://openmrs.org
المساهمات هي موضع ترحيب كبير، يمكننا بالتأكيد استخدام مساعدتكم!
ينظم OpenMRS امتيازات المساهمين في مراحل التطوير الموثقة هنا.
اقرأ الأقسام التالية لمعرفة أين يمكنك المساعدة.
تحقق من إرشادات المساهمة لدينا، واقرأ أدلة المطورين.
بعد أن قرأت؟ احصل على مشكلة تمهيدية Ready For Work
.
قد لا يكون لديك الوقت الكافي لتطوير نفسك ولكن لديك خبرة كافية في استخدام OpenMRS و/أو مراجعة التعليمات البرمجية، وستكون مساعدتك في مراجعات التعليمات البرمجية موضع تقدير كبير!
يقرأ
https://wiki.openmrs.org/display/docs/Code+Review
وابدأ بطلبات السحب re-:eyes:!
نحن نستخدم
https://www.transifex.com/openmrs/OpenMRS/
لإدارة ترجماتنا.
يعد ملف messages.properties
الموجود في هذا المستودع هو مصدرنا الوحيد للحقيقة. أنه يحتوي على أزواج المفاتيح والقيمة للغة الإنجليزية والتي هي الافتراضية.
يقوم Transifex بجلب تحديثات لهذا الملف كل ليلة والتي يمكن بعد ذلك ترجمتها بواسطتك وبواسطتي على موقع Transifex الإلكتروني نفسه. يمكننا في أي وقت سحب الترجمات الجديدة من Transifex وإعادتها إلى هذا المستودع. لغات أخرى مثل على سبيل المثال. ستكون اللغة الإسبانية بعد ذلك في ملف messages_es.properties
.
إذا كنت ترغب في معرفة كيفية المساعدة في الترجمات، راجع
http://openmrs.org/join-the-community/translate/
إذا كنت تريد المساعدة في إصلاح المشكلات الحالية أو وجدت خطأً وتريد إخبارنا، فيرجى الانتقال إلى
https://issues.openmrs.org
تحدث إلينا على OpenMRS Talk
MPL 2.0 w/HD © OpenMRS Inc.