Initial commit

อนุมัติเดินทาง-ประชุม(ธุรการ)/docs/installation_guide.md

@@ -0,0 +1,47 @@
+# คู่มือการติดตั้ง (Installation Guide)
+## ระบบขออนุมัติเดินทางประชุม-อบรม
+
+### 1. ความต้องการของระบบ (System Requirements)
+- PHP 8.3 หรือใหม่กว่า (เปิดใช้งาน pdo_mysql, mbstring, gd)
+- MySQL 8.0 หรือ MariaDB 10.5 ขึ้นไป
+- Apache (เปิดใช้งาน `mod_rewrite`) หรือ Nginx
+- Composer
+
+### 2. การติดตั้ง (Installation Steps)
+
+**2.1 โคลนซอร์สโค้ด และ ติดตั้ง Dependencies**
+```bash
+git clone <repository_url> trip-approval
+cd trip-approval
+composer install
+```
+
+**2.2 ตั้งค่าฐานข้อมูล (Database Setup)**
+1. สร้างฐานข้อมูลชื่อ `trip_approval_system` 
+2. นำเข้าโครงสร้างตารางจากไฟล์ `database/schema.sql` 
+   ```bash
+   mysql -u root -p trip_approval_system < database/schema.sql
+   ```
+3. สมมติฐานว่าระบบนี้เชื่อมต่อกับฐานข้อมูล `hosoffice_2566` (ตาราง `hr_person`) ที่มีอยู่เดิม
+
+**2.3 ตั้งค่าการเชื่อมต่อในซอร์สโค้ด (Configuration)**
+- เปิดไฟล์ `src/Core/Database.php` 
+- แก้ไข User, Password, DB Name สำหรับฝั่ง `$hrConnection` และ `$systemConnection` ให้ตรงกับเซิร์ฟเวอร์ของคุณ
+
+**2.4 ตั้งค่า Web Server (Apache)**
+- ให้ชี้ Document Root ของ Virtual Host ไปที่โฟลเดอร์ `public/`
+- ตัวอย่าง `.htaccess` ในโฟลเดอร์ `public/`
+  ```apache
+  RewriteEngine On
+  RewriteCond %{REQUEST_FILENAME} !-f
+  RewriteCond %{REQUEST_FILENAME} !-d
+  RewriteRule ^(.*)$ index.php [QSA,L]
+  ```
+
+### 3. การทดสอบเข้าระบบ
+- เข้าสู่ระบบด้วย Username/Password ที่มีอยู่ในตาราง `hr_person`
+- หรือเพิ่มข้อมูลจำลองในตาราง `hr_person` เพื่อทดสอบ
+
+### 4. การตั้งค่าเพิ่มเติม (Advanced Settings)
+- **Google Sheets**: เข้าไปที่ "ตั้งค่าระบบ" > "Google Sheets Integration" เพื่อระบุ Spreadsheet ID
+- **PDF Template**: เข้าไปที่ "ตั้งค่าระบบ" > "PDF Template Designer" เพื่ออัปโหลดฟอร์ม PDF ว่างเปล่า และลากวางตัวแปร