api: ทดสอบ: เครื่องมือ: เว็บ: webapp:
OpenMRS คือระบบเวชระเบียนที่อิงตามผู้ป่วย โดยมุ่งเน้นที่การให้ผู้ให้บริการมีระบบเวชระเบียนอิเล็กทรอนิกส์ (EMR) ที่ปรับแต่งได้ฟรี
ภารกิจของ OpenMRS คือการปรับปรุงการให้บริการด้านการดูแลสุขภาพในสภาพแวดล้อมที่มีทรัพยากรจำกัด โดยการประสานงานกับชุมชนระดับโลกที่สร้างแพลตฟอร์มระบบเวชระเบียนแบบโอเพ่นซอร์สที่แข็งแกร่ง ปรับขนาดได้ และขับเคลื่อนโดยผู้ใช้
OpenMRS เป็นแอปพลิเคชัน Java ซึ่งเป็นสาเหตุที่คุณต้องติดตั้ง Java JDK
หากคุณต้องการสร้างสาขาหลัก คุณจะต้องมี Java JDK เวอร์ชันขั้นต่ำ 8
ติดตั้งเครื่องมือสร้าง Maven
คุณต้องแน่ใจว่า Maven ใช้ Java JDK ที่จำเป็นสำหรับสาขาที่คุณต้องการสร้าง
หากต้องการดำเนินการดังกล่าว
mvn -version
ซึ่งจะบอกคุณว่า Maven ใช้เวอร์ชันใด โปรดดูเอกสาร Maven หากคุณต้องการกำหนดค่า Maven
ติดตั้งคอมไพล์เครื่องมือควบคุมเวอร์ชันและโคลนพื้นที่เก็บข้อมูลนี้ด้วย
git clone https://github.com/openmrs/openmrs-core.git
หลังจากที่คุณได้ดูแลข้อกำหนดเบื้องต้นแล้ว
ดำเนินการดังต่อไปนี้
cd openmrs-core
mvn clean package
สิ่งนี้จะสร้างแอปพลิเคชัน OpenMRS ใน webapp/target/openmrs.war
ซึ่งคุณจะต้องปรับใช้ในแอปพลิเคชันเซิร์ฟเวอร์ เช่น Tomcat หรือ Jetty
เพื่อวัตถุประสงค์ในการพัฒนา คุณสามารถปรับใช้ openmrs.war
ใน Application Server Jetty ได้ผ่านทาง
cd openmrs-core/webapp
mvn jetty:run
หากทุกอย่างเป็นไปด้วยดี (ตรวจสอบเอาต์พุตคอนโซล) คุณสามารถเข้าถึงแอปพลิเคชัน OpenMRS ได้ที่ localhost:8080/openmrs
โปรดดูการเริ่มต้นในฐานะนักพัฒนา - Maven สำหรับข้อมูลเพิ่มเติมเกี่ยวกับคำสั่ง Maven และตัวเลือกการสร้างที่มีประโยชน์
การสร้างนักเทียบท่ายังคงดำเนินการอยู่ เราขอขอบคุณข้อเสนอแนะและการปรับปรุงกระบวนการ
ข้อกำหนดเบื้องต้นที่จำเป็นเพียงอย่างเดียวคือ Docker
ในการสร้างเวอร์ชันการพัฒนาให้รัน:
docker-compose build
มันเรียก mvn install
ตามค่าเริ่มต้น หากคุณต้องการปรับแต่งอาร์กิวเมนต์ mvn build คุณสามารถทำได้โดยการรัน:
docker-compose build --build-arg MVN_ARGS= ' install -DskipTests '
นอกจากนี้ยังเป็นไปได้ที่จะใช้อิมเมจ dev ที่สร้างขึ้นเพื่อเรียกใช้ท่าเทียบเรือ:
docker-compose up
ในการสร้างเวอร์ชันที่ใช้งานจริงให้รัน:
docker-compose -f docker-compose.yml build
ขั้นแรกให้สร้างอิมเมจ dev จากนั้นจึงสร้างอิมเมจด้วย 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
You can run any tag available with:
TAG=nightly docker-compose -f docker-compose.yml up
นอกจากนี้ยังสามารถรันอิมเมจเวอร์ชันพัฒนาด้วย:
TAG=dev docker-compose up
เวอร์ชันการพัฒนาทั้งหมดมีส่วนต่อท้าย dev ส่วนต่อท้ายแคชมีไว้สำหรับ CI ของเรา
แผนผังโครงการได้รับการตั้งค่าดังนี้:
เอพีไอ/ | ไฟล์ Java และทรัพยากรสำหรับการสร้างไฟล์ java api jar |
เครื่องมือ/ | เมตาโค้ดที่ใช้ระหว่างการคอมไพล์และการทดสอบ ไม่เข้าไปในไบนารีที่รีลีสใดๆ (เช่น doclets) |
เว็บ/ | ไฟล์ Java และรีซอร์สที่ใช้ในไฟล์ webapp/war |
เว็บแอป/ | ไฟล์ที่ใช้ในการสร้างไฟล์ war (มีไฟล์ JSP ในเวอร์ชันเก่า) |
pom.xml | ไฟล์ Maven หลักที่ใช้สร้างและจัดทำแพ็กเกจ OpenMRS |
สำหรับการพัฒนาโมดูลอย่างรวดเร็วและโค้ด OpenMRS Platform โปรดดู SDK ที่ยอดเยี่ยมได้ที่
https://wiki.openmrs.org/display/docs/OpenMRS+SDK
OpenMRS มีสถาปัตยกรรมแบบโมดูลาร์ที่ช่วยให้นักพัฒนาสามารถขยายฟังก์ชันการทำงานหลักของ OpenMRS ด้วยการสร้างโมดูลที่สามารถเพิ่มหรือลบออกได้อย่างง่ายดาย เพื่อตอบสนองความต้องการของการใช้งานเฉพาะ
ก่อนที่จะสร้างโมดูลของคุณเอง ให้ไปที่ OpenMRS Module Repository และดูว่ามีโมดูลสำหรับกรณีการใช้งานเฉพาะของคุณอยู่แล้วหรือไม่ หากเป็นเช่นนั้น ให้ปรับใช้และลองใช้ และหากฟังก์ชันการทำงานหายไป ให้เข้าร่วมกับนักพัฒนาโมดูลเพื่อเพิ่มฟีเจอร์
หากคุณไม่พบสิ่งที่คุณกำลังมองหา โปรดดูโมดูล - wiki เพื่อเรียนรู้วิธีสร้างโมดูลใหม่
หากคุณต้องการมีส่วนร่วม โปรดดูแหล่งข้อมูลเหล่านี้
หากคุณกำลังมองหาคำแนะนำโดยละเอียดเกี่ยวกับวิธีการติดตั้ง กำหนดค่า มีส่วนร่วม และขยายการเยี่ยมชม OpenMRS
http://wiki.openmrs.org
หากคุณกำลังมองหาข้อมูลเพิ่มเติมเกี่ยวกับ OpenMRS ในฐานะการตรวจสอบองค์กร
http://openmrs.org
ยินดีเป็นอย่างยิ่ง เราสามารถใช้ความช่วยเหลือของคุณได้อย่างแน่นอน!
OpenMRS จัดระบบสิทธิพิเศษของผู้ร่วมให้ข้อมูลในขั้นตอนของนักพัฒนา ซึ่งมีการบันทึกไว้ที่นี่
อ่านส่วนต่อไปนี้เพื่อดูว่าคุณสามารถช่วยเหลือได้ที่ไหน
ดูหลักเกณฑ์การมีส่วนร่วมของเรา อ่านคู่มือนักพัฒนาซอฟต์แวร์
After you've read up ? หยิบประเด็นเบื้องต้นที่ Ready For Work
คุณอาจไม่มีเวลาในการพัฒนาตัวเองแต่มีประสบการณ์เพียงพอกับ OpenMRS และ/หรือการตรวจสอบโค้ด ความช่วยเหลือของคุณในการตรวจสอบโค้ดจะได้รับการชื่นชมอย่างมาก!
อ่าน
https://wiki.openmrs.org/display/docs/Code+Review
และเริ่มต้นด้วย re-:eyes: pull request!
เราใช้
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 พร้อม HD © OpenMRS Inc.