ข้ามไปที่เนื้อหา

การติดตั้ง

หน้านี้ครอบคลุม เส้นทางที่เร็วที่สุดในการได้ sandbox ที่ใช้งานได้ เพื่อให้คุณ สำรวจ HEMMS ได้ภายในไม่ถึง 10 นาที สำหรับการ deploy ระดับเซิร์ฟเวอร์ (reverse proxy, SSL, multi-worker, การสำรองข้อมูล) ให้ดู การดูแลระบบ — การติดตั้ง แทน

เวลาจนถึงการเข้าสู่ระบบครั้งแรก

ประมาณ 5–10 นาที บนแล็ปท็อปรุ่นใหม่ ส่วนใหญ่เป็นการรอให้ Docker ดึงอิมเมจและให้ Odoo ติดตั้ง addon

ข้อกำหนดเบื้องต้น

  • Docker + Docker Compose — ชุด Docker Desktop บน macOS / Windows หรือปลั๊กอิน docker + docker compose บน Linux
  • Git
  • RAM ว่างประมาณ 4 GB สำหรับการรันสแตก (Odoo + Postgres + ตัวคุณ)
  • พอร์ต TCP ว่างที่ 8069 สำหรับเซิร์ฟเวอร์ HTTP ของ Odoo

Apple Silicon / Linux ARM

อิมเมจทั้งหมดที่ใช้ (Odoo 18, Postgres 15) มี build แบบ native arm64 ดังนั้นคุณไม่จำเป็นต้องใช้ Rosetta หรือการจำลอง

ขั้นที่ 1 — โคลน repo

git clone https://github.com/jakapolr/hemms-demo
cd hemms-demo

repo นี้ประกอบด้วย:

  • docker-compose.yml — บริการ Odoo + Postgres สำหรับ sandbox สองชุด (hemms_demo สำหรับเผยแพร่ทั่วไป, hemms_private สำหรับผู้เช่าส่วนตัว)
  • addons/oca/ — โมดูล OCA ที่ vendor มา (อ่านอย่างเดียว)
  • addons/roots/ — สิบโมดูล roots_hemms_*
  • Makefile — เป้าหมายทางลัดที่ห่อหุ้มคำสั่ง docker compose ทั่วไป

ขั้นที่ 2 — เริ่มสแตก

สำหรับ sandbox โรงพยาบาลเอกชน (ชุดโมดูลเต็มรวมถึง HA Annual PM Report และ e-Signature):

make up-private
make install-private

make up-private จะบูต Postgres และ Odoo ส่วน make install-private จะเริ่มต้น ฐานข้อมูล hemms_private และติดตั้งโมดูล roots_hemms_* ทั้งสิบตัวตามลำดับ การพึ่งพาที่ถูกต้อง

sandbox สองชุด — เลือกหนึ่ง

  • hemms_demo — sandbox สำหรับเผยแพร่ทั่วไปแบบขั้นต่ำ (ใช้ make up-demo / make install-demo) ชุดข้อมูลตัวอย่างเล็กกว่า บูตเร็วกว่า
  • hemms_private — sandbox เต็มพร้อมข้อมูลตัวอย่างสำหรับทุกโมดูล นี่คือ ตัวเลือกที่เหมาะสมสำหรับการเดินสำรวจตามเอกสาร

คุณสามารถรันทั้งสองชุดควบคู่กันได้ ทั้งสองอยู่ใน Docker volume แยกกัน

ขั้นที่ 3 — เข้าสู่ระบบ

เปิด http://localhost:8069 ในเบราว์เซอร์ของคุณ

ข้อมูลรับรองเริ่มต้น (สำหรับ sandbox เท่านั้น):

ฟิลด์ ค่า
Database hemms_private (หรือ hemms_demo)
Email admin
Password admin

คุณควรจะมาถึงหน้าจอ Odoo Apps โดยมีแอป Maintenance ปรากฏใน launcher

ขั้นที่ 4 — ตรวจสอบว่า HEMMS ติดตั้งแล้ว

  1. คลิก launcher (มุมซ้ายบน) เปิด Maintenance

  2. แถบด้านบนควรแสดงเจ็ดรายการในลำดับนี้:

    Dashboard • Maintenance • Equipment • Asset Inspection •
Service Contracts • Reporting • Configuration

  3. คลิก Maintenance → Equipment คุณควรเห็นเครื่องมือแพทย์ตัวอย่างที่ป้อนไว้ พร้อม ป้ายระดับความวิกฤตแบบสัญญาณไฟจราจร (เขียว / เหลือง / แดง) ในแต่ละแถว

หากแถบด้านบนตรงกันและป้ายระดับความวิกฤตแสดงผล แสดงว่า HEMMS ติดตั้งถูกต้องแล้ว

แถบด้านบนแสดงเฉพาะ 'Maintenance / Reporting / Configuration'

โมดูล roots_hemms_* ยังไม่ได้ติดตั้ง ให้รัน make install-private ใหม่และตรวจสอบเอาต์พุตว่ามีโมดูลใดล้มเหลว เป้าหมาย install-private ใน Makefile จะพิมพ์การเปิดใช้งานแต่ละโมดูลตามลำดับ — ความล้มเหลวแรก มักเป็นข้อผิดพลาดของการพึ่งพา

ขั้นที่ 5 — หยุด / รีสตาร์ท

make down-private     # stop and remove the containers (keeps the DB volume)
make up-private       # restart with existing data
make destroy-private  # ⚠ wipe volumes — destroys the database

ปัญหาที่พบบ่อย

อาการ สาเหตุที่น่าจะเป็น วิธีแก้
port is already allocated สำหรับ 8069 Odoo / แอปอื่นผูกอยู่กับ 8069 หยุดบริการอื่น หรือเปลี่ยนพอร์ตที่เผยแพร่ใน docker-compose.yml
เบราว์เซอร์แสดง "Database not found" ไม่ได้รัน make install-* หลังจาก make up-* รันเป้าหมาย make install-* ที่สอดคล้องกัน
เข้าสู่ระบบได้แต่รายการ Equipment ว่างเปล่า ไม่ได้โหลดข้อมูลตัวอย่าง — คุณรัน --without-demo-data รัน make install-private ใหม่โดยไม่ override WITH_DEMO=1

ขั้นถัดไป?

  • การตั้งค่าครั้งแรก — สิ่งที่ต้องทำหลังการติดตั้ง เพื่อให้ได้โรงพยาบาลที่ใช้งานได้ (บริษัท แผนก พนักงาน ผู้ขาย เครื่องมือแพทย์ ระดับความวิกฤต แผน PM)
  • การดูแลระบบ — การติดตั้ง — การ deploy ระดับการใช้งานจริงพร้อม reverse proxy, SSL และการกำหนดค่า การสำรองข้อมูล
  • นักพัฒนา — CI/CD — การรันชุดทดสอบ 177 รายการ ในเครื่องด้วย make ci