คู่มือการใช้งาน Moobaan
เริ่มต้นใช้งาน · บทที่ 2

การติดตั้งระบบครั้งแรก

ติดตั้ง Moobaan ด้วยตัวช่วยติดตั้ง (Install Wizard) — เชื่อมฐานข้อมูล สร้างตารางอัตโนมัติ ตั้งข้อมูลหมู่บ้าน ผู้ดูแลระบบ และผู้ใหญ่บ้าน

ใครใช้ได้

ผู้ติดตั้งระบบ (ผู้พัฒนา/เจ้าของเครื่องเซิร์ฟเวอร์) ทำครั้งเดียวตอนเริ่มใช้งาน หลังติดตั้งเสร็จหน้านี้จะเข้าไม่ได้อีก

สิ่งที่ต้องเตรียม

  • เว็บเซิร์ฟเวอร์ที่รองรับ PHP 8.1 ขึ้นไป (แนะนำ 8.4) และ MySQL 5.7 / MariaDB 10.4 ขึ้นไป
  • ฐานข้อมูลว่าง 1 ฐาน พร้อมชื่อผู้ใช้และรหัสผ่าน (บนโฮสติ้งทั่วไปให้สร้างในแผงควบคุม เช่น cPanel ก่อน)
  • วางโฟลเดอร์ระบบ (moobaan_license) ไว้ในเว็บเซิร์ฟเวอร์ ระบบย่อยทั้ง 10 อยู่ในโฟลเดอร์ย่อยเดียวกันแล้ว
หมายเหตุ

ไม่ต้องแก้ไฟล์ตั้งค่าเอง เมื่อเปิดเว็บครั้งแรก ระบบจะพาไปหน้า /install อัตโนมัติ ส่วนการขึ้นเซิร์ฟเวอร์จริงแบบย้ายฐานข้อมูลเดิมไป ดูภาคผนวก — การนำระบบขึ้นเซิร์ฟเวอร์จริง

ขั้นที่ 1 · เชื่อมต่อฐานข้อมูล

หน้านี้แสดงเมื่อระบบยังเชื่อมต่อฐานข้อมูลไม่ได้

หน้าเชื่อมต่อฐานข้อมูลของตัวช่วยติดตั้ง
รูปที่ 2.1 หน้าเชื่อมต่อฐานข้อมูลของตัวช่วยติดตั้ง
  1. กรอก Host (ปกติคือ localhost) และ Port (ปกติ 3306)
  2. กรอก ชื่อฐานข้อมูล (Database) และ Username ที่สร้างไว้ ตัวอย่าง: moobaan_license / moobaan_prod
  3. กรอก รหัสผ่านฐานข้อมูล (ถ้ามี)
  4. กด "เชื่อมต่อฐานข้อมูล แล้วไปต่อ →"

ระบบจะทดสอบการเชื่อมต่อ ถ้าฐานข้อมูลยังไม่มี ระบบจะพยายามสร้างให้ แล้วบันทึกค่าลงไฟล์ config/database.local.php จากนั้นสร้างตารางทั้งหมดของระบบหลักและระบบย่อยทั้ง 10 ระบบให้อัตโนมัติ

ข้อความที่อาจพบ ความหมาย / วิธีแก้
กรอกชื่อฐานข้อมูลและ Username ให้ครบ ยังไม่ได้กรอกช่องที่มี *
Username/รหัสผ่านไม่ถูก… ตรวจสอบบัญชีฐานข้อมูลในแผงควบคุมโฮสติ้ง
ต่อฐานสำเร็จ แต่เขียนไฟล์ config/database.local.php ไม่ได้ ให้สิทธิ์เขียนโฟลเดอร์ config (เช่น chmod 775) แล้วลองใหม่
สร้างตารางฐานข้อมูลไม่สำเร็จ อ่านข้อความเพิ่มเติม แก้สาเหตุ แล้วกดรีเฟรช ระบบจะลองสร้างเฉพาะส่วนที่ยังไม่สำเร็จ

ขั้นที่ 2 · ตั้งค่าหมู่บ้านและบัญชีผู้ดูแล

เมื่อสร้างตารางเสร็จ จะเห็นฟอร์ม 4 ส่วน

ฟอร์มติดตั้งที่กรอกข้อมูลตัวอย่างของบ้านม่วงชุมแล้ว
รูปที่ 2.2 ฟอร์มติดตั้งที่กรอกข้อมูลตัวอย่างของบ้านม่วงชุมแล้ว

ส่วนที่ 1 — ข้อมูลหมู่บ้าน

ระบบนี้ใช้กับ 1 หมู่บ้านต่อ 1 ระบบ ข้อมูลทั้งหมดจะผูกกับหมู่บ้านนี้

ช่อง ตัวอย่าง หมายเหตุ
ชื่อหมู่บ้าน * บ้านม่วงชุม
หมู่ที่ * 5
รหัสหมู่บ้าน (ทะเบียนราษฎร์) 56090405 ไม่บังคับ
จังหวัด → อำเภอ → ตำบล * พะเยา → ภูซาง → ป่าสัก เลือกจังหวัดก่อน ระบบจะโหลดอำเภอ แล้วจึงตำบล

ส่วนที่ 2 — ผู้ดูแลระบบ (Super Admin)

บัญชีระดับสูงสุดสำหรับผู้พัฒนา/เจ้าของระบบ เข้าได้ทุกเมนูรวมถึงการตั้งค่า API

ช่อง ตัวอย่าง กฎ
Username * admin a-z 0-9 _ . - ยาว 3–50 ตัว
อีเมล admin@example.com ไม่บังคับ
ชื่อ * / นามสกุล วิชัย / รักษ์ระบบ
รหัสผ่าน * / ยืนยันรหัสผ่าน * •••••••• อย่างน้อย 8 ตัวอักษร และต้องตรงกัน
หมายเหตุ

บัญชี Super Admin ที่สร้างจากตัวติดตั้งเป็นบัญชี "ซ่อน" — ผู้ใช้คนอื่นจะไม่เห็นในรายชื่อ ค้นหา หรือ Audit log เพื่อความปลอดภัย ควรสร้างบัญชีผู้ดูแลระบบสำหรับใช้งานประจำอีกบัญชีภายหลัง

ส่วนที่ 3 — ผู้ใหญ่บ้าน / กำนัน

  • เลือก บทบาท: ผู้ใหญ่บ้าน หรือ กำนัน
  • กรอก Username *, ชื่อ *, นามสกุล, เบอร์โทร และ รหัสผ่าน * (อย่างน้อย 8 ตัว) ตัวอย่าง: phuyaiban นายสมชาย ใจดี 0812345678
  • ถ้ายังไม่พร้อม ติ๊ก "ข้ามขั้นนี้ — เพิ่มทีหลังจากเมนู "ผู้ใช้งาน"" ได้

ส่วนที่ 4 — ตั้งค่าระบบ

  • ชื่อระบบ (ที่แสดงในหน้าเว็บ) เช่น "Moobaan บ้านม่วงชุม"
  • คำอธิบายสั้น ๆ เช่น "ระบบกลางสำหรับชุมชนหมู่บ้าน"

กดติดตั้ง

กด "ติดตั้งระบบ" ระบบจะ

  1. สร้างหมู่บ้าน บัญชีผู้ดูแลระบบ และบัญชีผู้ใหญ่บ้าน (ถ้ากรอก) พร้อมมอบบทบาท
  2. สร้างกุญแจเข้ารหัสใหม่ (สำหรับเลขบัตรประชาชนและการล็อกอิน) บันทึกใน config/auth.local.php
  3. บันทึก URL จริงของเว็บ ปิดโหมด debug และตั้ง URL ของระบบย่อยทุกตัว
  4. แสดงข้อความ "ติดตั้งระบบสำเร็จ — เข้าสู่ระบบเพื่อใช้งานได้เลย" แล้วพาไปหน้าเข้าสู่ระบบ
ข้อความแจ้งเตือน สาเหตุ
กรุณากรอกชื่อหมู่บ้าน / กรุณากรอกหมู่ที่ ช่องบังคับว่าง
เลือกจังหวัด/อำเภอ/ตำบล ยังเลือกที่ตั้งไม่ครบ
username ต้องเป็น a-z 0-9 _.- ความยาว 3-50 ชื่อผู้ใช้มีอักษรไทยหรือช่องว่าง
รหัสผ่านต้องอย่างน้อย 8 ตัวอักษร / รหัสผ่านยืนยันไม่ตรงกัน ตรวจรหัสผ่านใหม่
username ซ้ำกับผู้ดูแลระบบ ชื่อผู้ใช้ของผู้ใหญ่บ้านต้องต่างจากผู้ดูแลระบบ
ข้อควรระวัง

ตัวติดตั้งมีตัวเลือกล้างฐานข้อมูล หลังติดตั้งเสร็จบนเครื่องจริง ควรกันไม่ให้เข้าถึงหน้า /install (ระบบจะพากลับหน้าแรกอัตโนมัติเมื่อติดตั้งแล้ว) และห้ามลบไฟล์ storage/installed.lock

หลังติดตั้งเสร็จ ควรทำอะไรต่อ

  1. เข้าสู่ระบบด้วยบัญชีผู้ดูแลระบบ (บทที่ 3)
  2. ตั้งค่าชื่อระบบ โลโก้ ภาพหน้า Login และนโยบายรหัสผ่านที่ ผู้ดูแลระบบ → ตั้งค่าระบบ
  3. ใส่โลโก้หมู่บ้านที่ ผู้ดูแลระบบ → ข้อมูลหมู่บ้าน (ใช้บนเอกสารที่พิมพ์)
  4. สร้างทะเบียนบ้านและผู้อาศัย (บทที่ 9) หรือนำเข้าบ้านเลขที่จากไฟล์ CSV
  5. แต่งตั้งบทบาท เช่น ผู้ช่วยผู้ใหญ่บ้าน กรรมการ (บทที่ 11)
  6. ตั้งบัญชีรับชำระเงิน QR พร้อมเพย์ (บทที่ 6)