add superset airbyte setup and merge md file

04-ingestion/QUICKSTART.md

@@ -0,0 +1,187 @@
+# Airbyte Quick Start Guide
+
+## สถาปัตยกรรม
+
+Airbyte ใช้ทรัพยากรร่วมจาก `01-infra`:
+- ✅ **PostgreSQL**: ฐานข้อมูลร่วม
+- ✅ **Nginx Proxy Manager**: Reverse proxy สำหรับเข้าถึงจากภายนอก
+- ✅ **Network**: `shared_data_network`
+
+**หมายเหตุสำคัญ**: `abctl` จะสร้าง `airbyte-proxy` (nginx ภายใน) สำหรับ routing ระหว่าง microservices ของ Airbyte เท่านั้น การเข้าถึงจากภายนอกใช้ Nginx Proxy Manager ที่มีอยู่แล้วใน `01-infra` **ไม่ต้องติดตั้ง nginx เพิ่มในโฟลเดอร์นี้**
+
+## วิธีติดตั้ง Airbyte OSS ด้วย abctl
+
+### ขั้นตอนที่ 1: เตรียม Infrastructure
+
+ตรวจสอบว่า PostgreSQL กำลังทำงาน:
+
+```bash
+cd ../01-infra
+docker compose --env-file ../.env.global up -d
+```
+
+รอจนกว่า PostgreSQL จะพร้อม (ประมาณ 10-30 วินาที)
+
+### ขั้นตอนที่ 2: ติดตั้ง Airbyte
+
+```bash
+cd ../04-ingestion
+
+# สำหรับ Linux/macOS
+bash setup-airbyte.sh
+
+# สำหรับ Windows (ใน Git Bash หรือ WSL)
+bash setup-airbyte.sh
+```
+
+การติดตั้งจะใช้เวลา 10-30 นาที ขึ้นอยู่กับความเร็วอินเทอร์เน็ต
+
+### ขั้นตอนที่ 3: เข้าใช้งาน
+
+**สำหรับ Production (ผ่าน Domain):**
+```
+https://ai.sriphat.com/airbyte
+```
+*หมายเหตุ: ต้องตั้งค่า Nginx Proxy Manager ก่อน (ดู NGINX-SETUP.md)*
+
+**สำหรับ Development/Local:**
+```
+http://localhost:8030
+หรือ
+http://[IP-ของเซิร์ฟเวอร์]:8030
+```
+
+กรอกข้อมูล:
+- Email: อีเมลของคุณ
+- Organization name: ชื่อองค์กร (เช่น Sriphat Hospital)
+
+### การจัดการ Airbyte
+
+**เริ่มต้น Airbyte:**
+```bash
+bash start-airbyte.sh
+```
+
+**หยุด Airbyte:**
+```bash
+bash stop-airbyte.sh
+```
+
+**ถอนการติดตั้ง:**
+```bash
+bash uninstall-airbyte.sh
+```
+
+## การตั้งค่าเพิ่มเติม
+
+### การตั้งค่าที่สำคัญ
+
+แก้ไขไฟล์ `.airbyte.env`:
+
+**Low Resource Mode (เปิดใช้งานอยู่แล้ว):**
+```bash
+LOW_RESOURCE_MODE=true  # เหมาะสำหรับเครื่องที่มี CPU < 4 cores
+```
+*หมายเหตุ: โหมดนี้จะปิดการใช้งาน Connector Builder*
+
+**เปลี่ยนพอร์ต:**
+```bash
+AIRBYTE_PORT=8030  # เปลี่ยนเป็นพอร์ตที่ต้องการ
+```
+
+**ตั้งค่า Domain:**
+```bash
+AIRBYTE_HOST=ai.sriphat.com  # Domain สำหรับเข้าถึงจากภายนอก
+```
+
+**เปิดใช้งาน Backup:**
+```bash
+ENABLE_BACKUP=true  # สร้าง backup script อัตโนมัติ
+BACKUP_SCHEDULE="0 2 * * *"  # ทุกวันเวลา 02:00 น.
+```
+
+### Authentication (ผ่าน Nginx Proxy Manager)
+
+Airbyte ไม่รองรับ Keycloak โดยตรง ใช้ Nginx Proxy Manager แทน:
+
+1. **OAuth2 Proxy + Keycloak** (แนะนำ) - ดู NGINX-SETUP.md
+2. **Basic Authentication** - ตั้งค่าใน Nginx Access List
+3. **IP Whitelist** - จำกัดการเข้าถึงตาม IP
+
+## การแก้ปัญหา
+
+### ติดตั้งไม่สำเร็จ
+
+1. ตรวจสอบว่า Docker กำลังทำงาน
+2. ตรวจสอบว่า PostgreSQL กำลังทำงาน: `docker ps | grep postgres`
+3. ตรวจสอบ logs: `abctl local logs`
+
+### เข้า UI ไม่ได้
+
+1. ตรวจสอบสถานะ: `abctl local status`
+2. ตรวจสอบ containers: `docker ps | grep airbyte`
+3. รีสตาร์ท: `bash stop-airbyte.sh && bash start-airbyte.sh`
+
+### ติดตั้ง abctl บน Windows
+
+ดาวน์โหลดจาก: https://github.com/airbytehq/abctl/releases
+
+## ฐานข้อมูล
+
+Airbyte ใช้ PostgreSQL ร่วมกับ infrastructure:
+- Database: `airbyte`, `temporal`, `temporal_visibility`
+- Host: `postgres` (container name)
+- Port: 5432
+- User/Password: ตามที่กำหนดใน `.env.global`
+
+ข้อมูลจะถูกสำรองอัตโนมัติพร้อมกับ PostgreSQL backup
+
+## Backup และ Restore
+
+### สำรองข้อมูล
+
+**Manual Backup:**
+```bash
+./backup-airbyte.sh
+```
+
+**ตั้งค่า Auto Backup (crontab):**
+```bash
+crontab -e
+# เพิ่มบรรทัดนี้สำหรับ backup ทุกวันเวลา 02:00 น.
+0 2 * * * cd /path/to/04-ingestion && ./backup-airbyte.sh
+```
+
+**ตำแหน่งไฟล์ Backup:**
+- โฟลเดอร์: `./backups/`
+- รูปแบบ: `airbyte_backup_YYYYMMDD_HHMMSS.tar.gz`
+- เก็บไว้: 7 วันล่าสุด (ลบอัตโนมัติ)
+
+### Restore ข้อมูล
+
+```bash
+# แตกไฟล์ backup
+tar -xzf backups/airbyte_backup_20260227_020000.tar.gz
+
+# Restore databases
+docker exec -i postgres psql -U postgres airbyte < airbyte_20260227_020000.sql
+docker exec -i postgres psql -U postgres temporal < temporal_20260227_020000.sql
+docker exec -i postgres psql -U postgres temporal_visibility < temporal_visibility_20260227_020000.sql
+```
+
+## ข้อมูลเพิ่มเติม
+
+### การตั้งค่า Nginx Proxy Manager
+ดูคู่มือโดยละเอียดที่: `NGINX-SETUP.md`
+
+### ทรัพยากรเพิ่มเติม
+- [Airbyte Documentation](https://docs.airbyte.com/)
+- [Connector Catalog](https://docs.airbyte.com/integrations/)
+- [Community Support](https://airbyte.com/community)
+
+### สถานะการติดตั้ง
+- ✅ Low Resource Mode: เปิดใช้งาน
+- ✅ Latest Stable Version: ใช้เวอร์ชันล่าสุด
+- ✅ Domain Access: ai.sriphat.com/airbyte
+- ✅ Backup: เปิดใช้งานอัตโนมัติ
+- ✅ Authentication: ผ่าน Nginx Proxy Manager