คู่มือการใช้งาน

Live Sample Data LIVE

ตัวอย่างข้อมูลจริงจาก Firebase (กดโหลดข้อมูลเพื่อแสดง)

ตัวอย่าง User Document

กดปุ่ม "โหลด" หรือ "โหลดข้อมูล Live" เพื่อดูตัวอย่าง

ตัวอย่าง Job Document

กดปุ่ม "โหลด" เพื่อดูตัวอย่าง

ตัวอย่าง Approval Document

กดปุ่ม "โหลด" เพื่อดูตัวอย่าง

ตัวอย่าง Share Document

Data Sync & Schema ใหม่!

ระบบ Sync ข้อมูลอัตโนมัติ และโครงสร้างข้อมูล

การทำงานของระบบ Auto-Sync

1. บันทึกงาน

หรือจ่ายค่าแรง

2. Auto Calculate

คำนวณ summary

3. อัพเดท Realtime

เว็บ + LINE ตรงกัน

Data Flow

บันทึกงาน / จ่ายค่าแรง
        │
        ▼
updateUserSummariesForTeam()
        │
        ▼
┌───────────────────────────────┐
│  คำนวณจาก jobs collection     │
│  - wage, adjustments          │
│  - paid/pending status        │
└───────────────────────────────┘
        │
        ▼
┌───────────────────────────────┐
│  อัพเดท users/{odooId}       │
│  - financialSummary           │
│  - jobSummary                 │
└───────────────────────────────┘
        │
        ▼
Firestore Realtime Listener
        │
        ├──► หน้าเว็บแสดงข้อมูลใหม่
        │
        └──► LINE Bot อ่านข้อมูลใหม่

เหตุการณ์ที่ Trigger Auto-Sync

saveJobOnly()

บันทึกงาน → อัพเดท user ใน team

markAsPaid()

จ่ายค่าแรง → อัพเดท balance

syncUserLineData()

กดปุ่ม Sync → อัพเดททุกคน + earnings

Users Collection

users/{odooId} - ข้อมูลพนักงาน

financialSummary (Auto-Synced)

Realtime

balance

เงินสะสม (ที่จ่ายแล้ว)

ตัวอย่าง: 110095.98

pendingPayment

รอรับเงิน

ตัวอย่าง: 24500

totalEarned

รวมทั้งหมด (balance + pending)

totalWage

รวมค่าแรง (ไม่รวมปรับ)

totalAdjustments

รวมปรับเงิน (บวก/ลบ)

lastCalculatedAt

คำนวณล่าสุดเมื่อ (ISO)

jobSummary (Auto-Synced)

Realtime

totalJobs

งานทั้งหมด

activeJobs

งานปัจจุบัน

completedJobs

งานเสร็จแล้ว

unpaidJobs

งานรอจ่ายเงิน

todayJobs

งานวันนี้

upcomingJobs

งานที่จะมาใน 7 วัน

ข้อมูลพื้นฐาน

userid

รหัสพนักงาน (LDB001)

odooUserId

Odoo User ID (number)

displayName

ชื่อที่แสดง

nickname

ชื่อเล่น

firstName

ชื่อจริง

lastName

นามสกุล

citizenId

เลขบัตร 13 หลัก

phone

เบอร์โทร

email

อีเมล

lineUserId

LINE User ID

รูปโปรไฟล์

ระบบจะดึงรูปจาก field ตามลำดับความสำคัญ:

profilePic

รูปโปรไฟล์หลัก

ลำดับที่ 1

photoURL

รูปจาก Google Auth

ลำดับที่ 2

photoUrl

รูป URL ทั่วไป

ลำดับที่ 3

avatar

รูป Avatar

ลำดับที่ 4

imageUrl

รูปทั่วไป

ลำดับที่ 5

profilePicture

รูปโปรไฟล์ (alt)

ลำดับที่ 6

ข้อมูลบัญชีธนาคาร (bankAccount object)

bankAccount เป็น object ที่มี fields ดังนี้:

bankAccount.bank

ชื่อธนาคาร

เช่น: "KBANK", "SCB", "BBL"

bankAccount.number

เลขบัญชี

เช่น: "123-4-56789-0"

bankAccount.name

ชื่อบัญชี

เช่น: "นายสมชาย ใจดี"

โลโก้ธนาคาร (bank-logos collection)

โลโก้ธนาคารเก็บใน collection: bank-logos

KBANK

SCB

BBL

KTB

BAY

TTB

GSB

BAAC

Document Structure:

// bank-logos/{BANK_CODE}
{
  logoUrl: "https://cloudinary.com/..."
}

หมายเหตุ: การดึงข้อมูลธนาคารต้องใช้ user.bankAccount.bank, user.bankAccount.number, user.bankAccount.name (ไม่ใช่ user.bankName หรือ user.bankAccount โดยตรง)

Jobs Collection

jobs/{jobId} - ข้อมูลงาน

ข้อมูลงานหลัก

name

ชื่องาน

startDate

วันเริ่มงาน (YYYY-MM-DD)

endDate

วันจบงาน

location

สถานที่

status

confirmed / pending / completed

income

รายได้รวมของงาน

โครงสร้าง team[] array

team: [
  {
    userId: "0WCCGJUeyaOJGOFFqluoA8unuOE3",
    name: "สิรวิชญ์",
    
    workdays: [
      { date: "2025-12-20", wage: 1500 },
      { date: "2025-12-21", wage: 1500 }
    ],
    
    adjustments: [
      { type: "bonus", name: "ค่าล่วงเวลา", amount: 500 }
    ],
    
    wageTotal: 3000,
    
    payment: {
      isPaid: true,
      paidAt: "2025-12-23T10:00:00Z"
    }
  }
]

team[].userId

Document ID ของ user

team[].workdays[]

วันทำงาน + ค่าแรง

team[].adjustments[]

ปรับเงินเพิ่ม/หัก

team[].payment.isPaid

สถานะจ่ายแล้ว (true/false)

Earnings Collection ใหม่!

earnings/{odooId} - สรุปรายได้

LINE LIFF Apps

หน้าเว็บในแอป LINE สำหรับ Freelancer

LIFF Register - หน้าสมัครสมาชิก

หน้าสำหรับให้ Freelancer สมัครสมาชิกผ่าน LINE

Endpoint URL:

https://your-domain.com/register.html

ตั้งค่าที่:

ตั้งค่า → LINE Integration → LIFF Register

LIFF Edit Profile - หน้าแก้ไขข้อมูล

หน้าสำหรับให้ Freelancer แก้ไขข้อมูลส่วนตัวผ่าน LINE

Endpoint URL:

https://your-domain.com/edit-profile.html

ตั้งค่าที่:

ตั้งค่า → LINE Integration → LIFF Edit Profile

📝 Fields ที่แก้ไขได้:

• ชื่อ-นามสกุล (TH/EN)

• ชื่อเล่น (TH/EN)

• เลขบัตรประชาชน

• วันเกิด

• รูปบัตรประชาชน

• หัก ณ ที่จ่ายอัตโนมัติ

• เบอร์โทร / อีเมล

• ข้อมูลบัญชีธนาคาร

Bank Logos - โลโก้ธนาคาร

โลโก้ธนาคารจะโหลดจาก Firebase Collection

Collection:

bank-logos

Document Structure:

// Document ID = Bank Code (e.g., KBANK, SCB, BBL)
{
  logoUrl: "https://cloudinary.com/..."
}

🏦 Bank Codes:

KBANK SCB BBL KTB BAY TTB GSB BAAC

LINE Auto-Reply Variables

ตัวแปรที่ใช้ใน Template

💰 ตัวแปรการเงิน

{balance}

เงินสะสม

{pendingPayment}

รอรับเงิน

{totalEarned}

รวมทั้งหมด

📋 ตัวแปรงาน

{totalJobCount}

งานทั้งหมด

{activeJobCount}

งานปัจจุบัน

{unpaidJobCount}

รอจ่ายเงิน

{todayJobCount}

งานวันนี้

{completedJobCount}

งานเสร็จ

👤 ตัวแปรผู้ใช้

{name}

ชื่อผู้ใช้

{odooId}

รหัสพนักงาน

{date}

วันที่ปัจจุบัน

Settings Collection

การตั้งค่าระบบ

Approvals Collection ใหม่!

approvals/{id} - ระบบอนุมัติจ่ายเงิน

ข้อมูลหลัก

title

ชื่อรายการ

ตัวอย่าง: "ตุลาคม 2568-Team Main"

itemNumber

เลขที่รายการ

ตัวอย่าง: "QA20251230045"

amount

ยอดเงินรวม (number)

type

ประเภท

"distribution" | "team-payment"

status

สถานะ

"pending" | "approved" | "rejected" | "cancelled"

note

หมายเหตุ

requester

ผู้ขออนุมัติ

createdAt

วันที่สร้าง (Timestamp)

distributionId

เชื่อมกับ shares collection

distributionData (object)

distributionData.customerName

ชื่อลูกค้า

distributionData.startDate

วันที่เริ่มงาน

distributionData.endDate

วันที่สิ้นสุดงาน

distributionData.entries[]

รายการผู้รับเงิน (array of objects)

{ name, amount, percent, type, teamMemberId, odooUserId, userid, profilePic, firstName, lastName, nickname, bankName, bankAccount, bankAccountName }

Shares Collection

shares/{id} - บันทึกจัดสัดส่วนเงิน

title

ชื่อรายการ

itemNumber

เลขที่รายการ (auto-generate)

startDate

วันที่เริ่ม (YYYY-MM-DD)

endDate

วันที่สิ้นสุด (YYYY-MM-DD)

teamType

ประเภททีม (Main, Secondary)

jobIds[]

รายการ job IDs ที่เลือก

entries[]

รายการแบ่งสัดส่วน

context

ข้อมูลบริบท (customerName, etc.)

createdAt

วันที่สร้าง (Timestamp)

entries[] structure

type

"team" | "custom"

teamMember

ชื่อทีมงาน (ถ้า type=team)

teamMemberId

odooUserId ของทีมงาน

customLabel

ป้ายกำกับ (ถ้า type=custom)

percent

เปอร์เซ็นต์ (0-100)

amount

จำนวนเงิน (number)

paid

จ่ายแล้ว (boolean)

Custom Labels Collection

customLabels/{id} - ป้ายกำกับรายการกำหนดเอง

Followers Collection

followers/{lineUserId} - ผู้ติดตาม LINE OA