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

- กรอก Host (ปกติคือ
localhost) และ Port (ปกติ3306) - กรอก ชื่อฐานข้อมูล (Database) และ Username ที่สร้างไว้ ตัวอย่าง:
moobaan_license/moobaan_prod - กรอก รหัสผ่านฐานข้อมูล (ถ้ามี)
- กด "เชื่อมต่อฐานข้อมูล แล้วไปต่อ →"
ระบบจะทดสอบการเชื่อมต่อ ถ้าฐานข้อมูลยังไม่มี ระบบจะพยายามสร้างให้ แล้วบันทึกค่าลงไฟล์ config/database.local.php จากนั้นสร้างตารางทั้งหมดของระบบหลักและระบบย่อยทั้ง 10 ระบบให้อัตโนมัติ
| ข้อความที่อาจพบ | ความหมาย / วิธีแก้ |
|---|---|
| กรอกชื่อฐานข้อมูลและ Username ให้ครบ | ยังไม่ได้กรอกช่องที่มี * |
| Username/รหัสผ่านไม่ถูก… | ตรวจสอบบัญชีฐานข้อมูลในแผงควบคุมโฮสติ้ง |
| ต่อฐานสำเร็จ แต่เขียนไฟล์ config/database.local.php ไม่ได้ | ให้สิทธิ์เขียนโฟลเดอร์ config (เช่น chmod 775) แล้วลองใหม่ |
| สร้างตารางฐานข้อมูลไม่สำเร็จ | อ่านข้อความเพิ่มเติม แก้สาเหตุ แล้วกดรีเฟรช ระบบจะลองสร้างเฉพาะส่วนที่ยังไม่สำเร็จ |
ขั้นที่ 2 · ตั้งค่าหมู่บ้านและบัญชีผู้ดูแล
เมื่อสร้างตารางเสร็จ จะเห็นฟอร์ม 4 ส่วน

ส่วนที่ 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 บ้านม่วงชุม"
- คำอธิบายสั้น ๆ เช่น "ระบบกลางสำหรับชุมชนหมู่บ้าน"
กดติดตั้ง
กด "ติดตั้งระบบ" ระบบจะ
- สร้างหมู่บ้าน บัญชีผู้ดูแลระบบ และบัญชีผู้ใหญ่บ้าน (ถ้ากรอก) พร้อมมอบบทบาท
- สร้างกุญแจเข้ารหัสใหม่ (สำหรับเลขบัตรประชาชนและการล็อกอิน) บันทึกใน
config/auth.local.php - บันทึก URL จริงของเว็บ ปิดโหมด debug และตั้ง URL ของระบบย่อยทุกตัว
- แสดงข้อความ "ติดตั้งระบบสำเร็จ — เข้าสู่ระบบเพื่อใช้งานได้เลย" แล้วพาไปหน้าเข้าสู่ระบบ
| ข้อความแจ้งเตือน | สาเหตุ |
|---|---|
| กรุณากรอกชื่อหมู่บ้าน / กรุณากรอกหมู่ที่ | ช่องบังคับว่าง |
| เลือกจังหวัด/อำเภอ/ตำบล | ยังเลือกที่ตั้งไม่ครบ |
| username ต้องเป็น a-z 0-9 _.- ความยาว 3-50 | ชื่อผู้ใช้มีอักษรไทยหรือช่องว่าง |
| รหัสผ่านต้องอย่างน้อย 8 ตัวอักษร / รหัสผ่านยืนยันไม่ตรงกัน | ตรวจรหัสผ่านใหม่ |
| username ซ้ำกับผู้ดูแลระบบ | ชื่อผู้ใช้ของผู้ใหญ่บ้านต้องต่างจากผู้ดูแลระบบ |
ตัวติดตั้งมีตัวเลือกล้างฐานข้อมูล หลังติดตั้งเสร็จบนเครื่องจริง ควรกันไม่ให้เข้าถึงหน้า /install (ระบบจะพากลับหน้าแรกอัตโนมัติเมื่อติดตั้งแล้ว) และห้ามลบไฟล์ storage/installed.lock
หลังติดตั้งเสร็จ ควรทำอะไรต่อ
- เข้าสู่ระบบด้วยบัญชีผู้ดูแลระบบ (บทที่ 3)
- ตั้งค่าชื่อระบบ โลโก้ ภาพหน้า Login และนโยบายรหัสผ่านที่ ผู้ดูแลระบบ → ตั้งค่าระบบ
- ใส่โลโก้หมู่บ้านที่ ผู้ดูแลระบบ → ข้อมูลหมู่บ้าน (ใช้บนเอกสารที่พิมพ์)
- สร้างทะเบียนบ้านและผู้อาศัย (บทที่ 9) หรือนำเข้าบ้านเลขที่จากไฟล์ CSV
- แต่งตั้งบทบาท เช่น ผู้ช่วยผู้ใหญ่บ้าน กรรมการ (บทที่ 11)
- ตั้งบัญชีรับชำระเงิน QR พร้อมเพย์ (บทที่ 6)