🌳 ระบบสาย (Downline Hierarchy)

ระบบมี 6 ระดับ เรียงจากสูง→ต่ำ:

แอดมิน (admin / Company) — ระดับสูงสุด ธนาคารกลาง
   └── ซูเปอร์ซีเนีย (super_senior)
        └── ซีเนียร์ (senior)
             └── มาสเตอร์ (master)
                  └── เอเย่นต์ (agent)
                       └── ลูกค้า (customer) — เล่นเกมได้

• คุณสร้างได้ ระดับต่ำกว่าตัวเอง เท่านั้น (เช่น senior สร้าง master/agent/customer ได้)
• ทุก user ต้องอยู่ใต้สายใดสายหนึ่ง (ยกเว้น admin)
• ค่าต๋ง / สติกเกอร์ / ตัวละคร / ค่าสร้างห้อง → กระจายขึ้นบนตาม hold% (ดูหัวข้อ 💼 รายได้)
• ลูกค้า = role=null + ไม่มี is_admin — เล่นเกมได้คนเดียวเท่านั้น (agent/admin เล่นเกมไม่ได้)

👥 สร้าง Agent / ลูกค้า

มี 2 ปุ่มแยกแท็บ:

• ที่แท็บ 🌐 ลูกสาย ปุ่ม ➕ สร้างลูกสาย — สร้าง super_senior/senior/master/agent ใต้คุณ
• ที่แท็บ 👤 สมาชิก ปุ่ม 👤 สร้างสมาชิก — สร้างลูกค้าเล่นเกม ใต้คุณ

กฎ username:

• username ของลูกสาย ต้องขึ้นต้นด้วย username ของคุณ (เช่น คุณ ah → ลูก ahtest)
• ตัวต่อ (suffix) เป็น a-z, 0-9, _ เท่านั้น
• รวม prefix แล้วยาว 2-16 ตัว

Auto-API Key — agent ทุก role (รวม super_senior/senior/master/agent + admin) ได้ key อัตโนมัติตอนสร้าง → เรียก /api/v1/* ผ่าน X-API-Key

💰 hold % (ถือสู้)

ตอนสร้างลูกสาย agent ต้องตั้ง hold % = สัดส่วนที่ลูกสายนั้น "ถือเล่นเอง" (เก็บไว้ที่ตัวเอง ไม่ส่งต่อขึ้น)

• ตั้ง hold % ให้ลูก ≤ hold % ของคุณ เสมอ (กันเสีย margin ของตัวเอง)
• ลูกค้า (customer) hold = 0% เสมอ (ไม่มีสายต่อ)
• Admin (Company) ถือ 100% โดย default (ทุกอย่างที่ไม่มีใครเก็บ ตกที่ Admin)
• เคสตัวอย่าง: คุณ super_senior ถือ 100%, ลูก senior ถือ 90%
  → senior เก็บ 90%, ส่วนต่าง 10% absorb ขึ้นมาที่คุณ

รายได้ T บาท → cascade ขึ้น:
  Agent (hold 50)    keep 50%        pass up 50%
  Master (hold 80)   keep 30% (80−50) pass up 20%
  Senior (hold 90)   keep 10% (90−80) pass up 10%
  Super (hold 100)   keep 10% (100−90) pass up 0%
  Admin              keep 0           (Top — owner ของส่วนที่เหลือ)

ดูเปอร์เซ็นต์ที่คุณถือ: ดูที่ topbar — Senior · ถือ 90%

💸 agent_credit (เครดิตเติม)

agent_credit = "เครดิตสำหรับเติมให้ลูกค้า/ลูกสาย" — แยกจาก points ของ agent เอง

• admin มีเครดิตไม่จำกัด ∞ (ธนาคารกลาง)
• agent ระดับอื่น ต้องได้รับเครดิตจาก parent ก่อน → ค่อยเติมต่อให้ลูก
• เติมให้ลูกค้า: หัก agent_credit ของคุณ → +points ของลูกค้า
• เติมให้ลูกสาย: หัก agent_credit ของคุณ → +agent_credit ของลูก
• ถอนคืน: หัก points/credit ของ target → +agent_credit ของคุณ
• ติดลบได้: agent_credit อนุญาตให้ติดลบ (ระบบเครดิต) — เครียกันทีหลังที่แท็บ 📊 รายงานสาย หรือ 🌐 ข้ามเว็บ

⚠️ คำเตือน: agent_credit ใช้จ่ายค่าคอม Aff ด้วย — ถ้าใกล้หมด/ติดลบ ค่าคอมจะ "รอจ่าย" (ดูหัวข้อ 🎁 Aff)

💼 รายได้ทั้งหมด + การกระจาย

ระบบเก็บเงินลูกค้าหลายประเภท → กระจายขึ้นสายตาม hold% ของแต่ละชั้น:

• 💰 ค่าต๋งเกม — หักทุก event ที่ลูกค้าได้เงิน (Tier 3-15%, ตามยอดเติม) → ดูหัวข้อ 📅 Tier + ค่าต๋ง
• 🎁 สติกเกอร์ — ซื้อเซ็ต/ตัว, ส่งสติกเกอร์
• 🎭 ตัวละคร — ซื้อตัวละคร
• 🏠 ค่าสร้างห้อง — เฉพาะห้องส่วนตัวเท่านั้น (host จ่ายครั้งเดียวต่อ session)
• ✏️ ค่าเปลี่ยนชื่อ — ทุกครั้งที่ลูกค้าเปลี่ยน display name

ดูได้ที่ tab ต่าง ๆ:

• 💼 รายได้ทั้งหมด — สรุปยอดที่คุณได้รับ + แยก "ฉันเก็บ" vs "ส่งบน" ตาม hold% ของคุณ
• 📈 รายวัน — P&L รายวัน 30/60 วันย้อนหลัง พร้อมยอดเก็บ/ส่งบน
• 🎮 ประวัติเกม — เกมที่ลูกค้าใต้สายเล่น (กรองโดย ผู้เล่น/ผู้ชนะ/Room)
• 📋 Pay Logs — log การเงินทุก event (กันโกง/debug, กรอง 8 ช่อง)

💡 Default = วันนี้ — ทุกหน้าที่มี date filter จะเริ่มที่ "วันนี้" อัตโนมัติเมื่อเปิดครั้งแรก

📊 รายงานสาย (Drill-down Report)

หน้าเด่นของระบบเครียยอด — แสดง ทุกชั้นพร้อมกัน + drill-down ลึกได้

โครงสร้างตาราง:

ID | บทบาท | ผู้เล่น | Member | Agent | Master | Senior | Super Senior | Company

• "(ฉัน) ROLE" หน้าชั้นของคุณ → ติด สีทอง
• Banner ด้านบน บอกว่ากำลังดูใคร (🟡 ของตัวเอง / 🔵 drill เข้าไปดูดาวไล)
• คลิก ID ของดาวไล → drill ลงไปดูใต้สายเขา
• คลิก ID ลูกค้า → ดู transactions รายตัว

Filter:

• 📅 ช่วงเวลา preset: วันนี้/เมื่อวาน/อาทิตย์นี้/อาทิตย์ที่แล้ว/เดือนนี้/เดือนที่แล้ว
• 🎯 หรือกำหนดวันที่เอง
• 💸 ประเภทรายการ: ค่าต๋ง / สติกเกอร์ / ตัวละคร / ค่าสร้างห้อง / เปลี่ยนชื่อ

💡 เลข 4 ทศนิยม — แสดง 2 ทศนิยม, คลิกที่เลข เพื่อขยายดู 4 ตำแหน่ง

🌐 เครียยอดข้ามเว็บ + บอท

เครียเงินสด ระหว่าง Super Senior ต่างเว็บ (เมื่อลูกค้าจากเว็บ A เล่นกับลูกค้าจากเว็บ B ในห้องสาธารณะ)

• 🟡 ของฉันเอง (SS view) — เห็น creditors/debtors + ปุ่ม "เครียยอด" ย้าย agent_credit จริง
• 🔵 ของดาวไล (Senior/Master/Agent view) — ดูเฉย ๆ ไม่เครียได้
• เครียคู่ → ระบบ atomic move agent_credit ระหว่าง SS A ↔ SS B

ตัวกรอง:

• 📅 ช่วงเวลา (preset + custom)
• 💸 ทั้งหมด / ข้ามเว็บยังไม่เครีย / ข้ามเว็บเครียแล้ว

ℹ️ ถ้ามี SS แค่คนเดียวในระบบ → หน้านี้จะว่าง (ไม่มีคู่ให้เครีย) — เครียยอดภายในสายไปที่ 📊 รายงานสาย แทน

🤖 บอท (ผู้เล่นจำลอง)

ระบบมีบอทผู้เล่นจำลอง (fk*) ที่เข้าห้องสาธารณะกับลูกค้าจริง

การไหลของเงินกับบอท:

• 🤖 บอทชนะคน (ลูกค้าเสีย X) → cascade ขึ้นสาย เป็น positive rake — สายเก็บส่วนแบ่งตาม hold% (เหมือนค่าต๋ง)
• 🎁 บอทแพ้คน (ลูกค้าได้ X) → cascade ลงสาย เป็น negative rake — สายล่างออกเงินให้ลูกค้าก่อน แล้วเก็บข้างบนเป็นชั้น ๆ
• = บอท W/L = ค่าต๋งปกติ (แต่ทิศทางตามแพ้/ชนะ)

💡 บอทไม่อยู่ในแท็บ 🌐 ข้ามเว็บแล้ว — ถูก reroute เข้าสายปกติ ดูผลกระทบที่ 📊 รายงานสาย

⚙️ Cross-play + Bots — ตั้งค่า

ที่ tab ⚙️ ตั้งค่า มี 2 ส่วน — แต่ละส่วน 2 toggle:

🔓 Cross-play (เล่นข้ามสาย)

• เปิดให้สายฉันเอง — ลูกค้าตรงของคุณเล่นข้ามสายได้
• ให้สายล่างเลือกเอง — ปลดล็อกให้สายล่างปรับเอง (ถ้าปิด → สายล่างถูก force off)

🤖 บอท (ผู้เล่นจำลอง)

• เปิดให้บอทเข้าห้องสายฉัน — บอทเข้าห้องลูกค้าของคุณได้
• ให้สายล่างเลือกเอง — เหมือนกัน

⏱️ Cache 1 นาที — เปลี่ยนแล้วมีผลทันที (รออัพเดท 1 นาที); ลูกค้าที่กำลังเล่นในห้องอยู่ ไม่ถูกเตะออก

🎁 ระบบ Aff (แนะนำเพื่อน)

ทุกลูกค้าได้ ref_code อัตโนมัติ → ส่งให้เพื่อน → เพื่อนสมัครกรอกรหัสในฟอร์ม "👤 สร้างสมาชิก"

1. ลูกค้า A ได้ ref_code (เช่น A8K2X9MP) ในเมนู "🎁 ชวนเพื่อน" หน้าเกม
2. A ส่งรหัสให้เพื่อน B → Agent สร้าง B + กรอก ref_code ของ A
3. B เสียค่าต๋ง 100฿ → ระบบหัก agent_credit ของ Agent A 5฿ (5%) → +5฿ เข้า aff_wallet ของ A
4. A กด "💸 ถอน" ในเมนู "🎁 ชวนเพื่อน" → +5฿ เข้า points

ตั้งค่าได้ที่ tab "🎁 ค่าคอม Aff":

• % — ตั้งให้แต่ละลูกค้า (default 5%, 0-100%)
• ตารางถอน: anytime / daily / monthly / days:1,15

💡 ค่าคอม Aff ไม่นับ Tier (ไม่เข้า topups) → ลูกค้าโกง tier ด้วยการชวนกันไม่ได้

⚠️ agent_credit ไม่พอ? → ค่าคอม mark "รอจ่าย" → เติม credit เมื่อไหร่ ระบบจ่ายทันที

🚫 ข้ามสาย Aff (Cross-Branch Referral) — ปิด

นโยบายใหม่: ผู้แนะนำต้องอยู่ "สายเดียวกัน" เท่านั้น — ข้ามสายไม่ได้

[Master ABC] ──→ [Agent X] ──→ [ลูกค้า A]   (มี ref_code)
                            └→ [Agent Y] ──→ [ลูกค้า B]   ← ใช้ ref ของ A ได้
                                                            (ทั้งคู่อยู่ใต้ Master ABC)

✓ อนุญาต: ผู้แนะนำเป็น caller เอง หรือ คนใต้สาย caller (ดาวไลน์)

❌ บล็อก: ถ้าผู้แนะนำอยู่คนละสาย → ระบบไม่ให้สมัครเลย — ต้องเปลี่ยนรหัส หรือสมัครโดยไม่ใส่รหัส

หมายเหตุ: ระบบเช็คทั้ง chain ของพ่อแม่ (parent_id recursive) ไม่ใช่แค่ระดับเดียว — ลูกค้าทุกคนใต้สายเดียวกัน (รวมหลายชั้น) แนะนำกันได้หมด

📅 Tier (รายวัน) + ค่าต๋ง (Rake)

1. Tier — เลื่อนตามยอดเติมเครดิตรายวัน

• ดูได้ที่หน้าผู้เล่น "🏆 อันดับ" / topbar — เช่น Bronze 🥉 (3%)
• นับ "ยอดเติมรายวัน" (Bangkok midnight reset) → tier สูงขึ้น = ค่าต๋ง % ลดลง

✅ ที่นับเป็นยอดเติม:

• Agent / Senior / Master / Super Senior เติมให้ลูกค้าผ่าน Downline panel
• Admin เติมผ่านหลังบ้าน (ถ้าติ๊ก "นับเป็นยอดเติม")
• API /api/v1/wallet/topup
• อนุมัติ Topup Request

❌ ที่ไม่นับเป็นยอดเติม:

• ลูกค้าชนะเกม / ได้เงินจากบอท
• Cashback (คืนยอดเสีย)
• รางวัล Monthly Event / Tournament prize
• Tournament refund
• Aff withdrawal (aff_wallet → points)
• Admin adjust ที่ติ๊ก "ไม่นับเป็นยอดเติม" (เช่น ชดเชย/รางวัล)

2. ค่าต๋ง (Rake) — หักทุก event ที่ได้เงิน (v10)

ตัวอย่าง: tier Bronze (feePct = 15%)
  ลูกค้า A "เกิดหัว" +10฿ → ระบบหัก ค่าต๋ง 1.5฿ ทันที (เหลือ 8.5฿)
  ลูกค้า A "ตีโง่" -5฿  → ไม่หัก (เสียเงินไม่หักค่าต๋ง)
  ลูกค้า A "ตีเต็ม" +20฿ → หัก ค่าต๋ง 3.0฿ ทันที (เหลือ 17฿)
รวมรอบนี้: ลูกค้าได้ 30 − 5 − 4.5 = 20.5฿ → ระบบเก็บค่าต๋งรวม 4.5฿

⚠️ Migration v10 — ระบบเดิมหัก rake บน net delta (เฉพาะคนที่ได้เงินรวมเป็น +). ตอนนี้หักทุก event ที่ได้เงิน ทั้งหมด → revenue agent เพิ่มขึ้น (ขึ้นกับ pattern การเล่น) — มีผลทุกเกม (ดัมมี่/ป๊อกเด้ง/หมากฮอส)

⚡ ทะลุบอท (Per-Customer)

เปิดให้บอทเข้าห้อง "ลูกค้าคนเดียว" ได้ — ใช้กรณีลูกค้าน้อย/หาคู่เล่นยาก

• ปุ่ม ⚡ ในตารางสมาชิก (แท็บ 👤 สมาชิก) — คลิกเปิด/ปิด
• เปิด ⚡ ทะลุบอท ปุ่มเปลี่ยนเป็นสีส้ม + ตั้ง "📋 ทะลุบอท" filter ใน sub-tab ได้

พฤติกรรมเมื่อเปิด ⚡:

• บอทเข้าห้องของลูกค้าคนนี้ได้ แม้สายบนปิดบอทไว้ (override bots_allowed chain)
• ยังเน้นจับคู่กับคนจริงก่อน — บอทเป็น standby rescue (รอ ~90-120 วิ ค่อยมาเข้า)
• ลูกค้าคนนี้เข้าห้องบอท (fakePool) ได้ด้วย
• ไม่กระทบลูกค้าคนอื่นในสายเดียวกัน

🛡️ ถ้า Admin ปิดบอททั้งระบบ (Master Kill Switch ที่ /admin#pane=fakeusers) → ปุ่ม ⚡ จะหายไปจากทุกแถวเลย — เพราะตั้งให้แล้วก็ไม่มีผล

🎁 ตั้งค่าคอม Aff รายลูกค้า

ตั้ง % คอม Aff เป็นรายบุคคล — เช่น VIP ให้ 10%, ปกติให้ 5%

• ปุ่ม 🎁 5% / 🎁 7% ในตารางสมาชิก — คลิกเปิด modal ตั้งค่า
• ปุ่มสีม่วงสด = ตั้งค่าเองแล้ว (≠ default 5%)
• ปุ่มสีจาง = ยังใช้ default 5%

ขั้นต่ำ 5% — สำหรับ agent ทุกระดับ ตั้งต่ำกว่าไม่ได้ (admin override ได้)

ตารางถอน: ตลอดเวลา / ทุกวัน / วันที่ 1 / วันที่ 15 / วันที่ 1+15 / กำหนดเอง

💡 ใช้คู่กับหน้า 🎁 ค่าคอม Aff — ดูสรุปคอมทั้งหมด + Top earners ที่นั่น

🚫 ห้ามถอนเครดิตขณะเล่นเกม

ลูกค้ากำลังเล่นเกมอยู่ (ยังไม่จบรอบ) → ระบบ ห้ามถอน/ลดเครดิต ทุกทาง

• ❌ Downline panel ปุ่ม "↩️ ถอน" → error
• ❌ Admin หลังบ้าน → error
• ❌ API /api/v1/wallet/withdraw → HTTP 409

Error message: ⚠️ ผู้เล่น "xxx" อยู่ในระหว่างเล่นเกม — ไม่สามารถถอนเครดิตได้ กรุณารอจบเกม/รอบก่อน

เงื่อนไข "กำลังเล่น":

• อยู่ในห้อง + game ทำงานอยู่ (phase ≠ 'ended')
• ในห้องแต่ยังไม่เริ่มเกม (lobby) → ถอนได้ปกติ
• ป๊อกเด้ง/หมากฮอส phase = 'ended' (รอรอบใหม่) → ถอนได้

✅ เติมเครดิตยังทำได้ปกติ — แค่ถอนเท่านั้นที่บล็อก

🔑 API Key + Subdomain

1. API Key — Agent ทุก role + admin ได้ key auto-gen ตอนสร้าง

• ดูได้ที่ ปุ่ม "🔑 API Key" ในเมนูซ้าย (หมวด เครื่องมือ)
• ใช้ header X-API-Key: ... เรียก /api/v1/* (ดู 📚 API Docs)
• สร้าง key ใหม่ได้ตลอดเวลา (key เก่าถูกยกเลิก)

2. Subdomain (v10) — แยกตามหน้าที่

https://play.pokstack.com       ← ลูกค้าเข้าเล่นเกม
https://admin.pokstack.com      ← admin หลังบ้าน
https://downline.pokstack.com   ← agent/senior/master/agent (หน้านี้)
https://apis.pokstack.com       ← เรียก API (ทุก /api/v1/*) ★
https://api.pokstack.com        ← alias ของ apis (ใช้ได้เหมือนกัน)

⚠️ เรียก API จาก PHP/backend → ต้องใช้ https://apis.pokstack.com (เรียก play.pokstack.com จะถูก block 403)

❓ FAQ

Q: รายได้ที่ได้รับ vs ที่ต้องส่งบน คำนวณยังไง?
A: ตาม hold% ของคุณ — ดูในแท็บ 💼 รายได้ทั้งหมด มี stat cards แสดงชัด: ฉันเก็บ = gross × hold/100, ส่งบน = gross × (100-hold)/100

Q: เครียยอดภายในสายที่ไหน vs ข้ามเว็บที่ไหน?
A: ภายในสาย (chain เดียวกัน) ที่ 📊 รายงานสาย — drill-down ลึก. ข้ามเว็บ (SS ต่างเว็บ) ที่ 🌐 ข้ามเว็บ — ต้องเป็น SS หรือ Admin ถึงเครียได้

Q: ห้องสาธารณะ vs ส่วนตัว ต่างกันยังไง?
A:

• 🌏 ห้องสาธารณะ — ฟรี ไม่มีค่าสร้างห้อง, ทุกคนเสียแค่ค่าต๋ง
• 🔒 ห้องส่วนตัว — host จ่ายค่าสร้างห้อง 1 ครั้งตอนเริ่มเกมแรก, ทุกคนเสียค่าต๋งปกติ

Q: บอท W/L ไปอยู่ที่ไหน?
A: cascade เข้าสายเหมือนค่าต๋งปกติ — ดูที่ 📊 รายงานสาย filter "🎮 ผลเกม + บอท" (หรือเปิด filter ทั้งหมด)

Q: ลูกค้าเสียค่าต๋งแล้วได้คอม Aff เข้ากระเป๋าหลักทันทีไหม?
A: ❌ ไม่ — ต้องสะสมในกระเป๋า aff แล้ว กดถอนเอง → เข้า points

Q: ค่าคอม Aff นับ Tier ไหม?
A: ❌ ไม่นับ — tier ของผู้แนะนำไม่เลื่อนขึ้นจากการชวนเพื่อน (ป้องกันโกง)

Q: ลูกค้ามีกระเป๋ากี่ใบ?
A: 3 ใบ:

• points — เล่นเกม + ซื้อของ + ถอนเงิน
• bonus_points — ซื้อ cosmetic (ไม่ใช้เล่น)
• aff_wallet — ค่าคอมจากแนะนำเพื่อน (ต้องกดถอน → points)

Q: agent_credit หมด แต่มีลูกค้าที่ชวนเพื่อนเสียค่าต๋ง?
A: ค่าคอม mark "⏳ รอจ่าย" → เก็บไว้ใน aff_commissions → เมื่อ topup credit ครั้งถัดไป → ระบบจ่าย pending อัตโนมัติ

Q: ผมโดน AFK ในเกม — ระบบทำยังไง?
A: หมดเวลา 3 ตาติด + ออฟไลน์ → เตะออกห้อง + ลบ userRoom map → reconnect ครั้งใหม่ไป lobby ปกติ ไม่กลับมาห้องเดิม

Q: ลูกค้าโดนหัก "ค่าสร้างห้อง" จากการเล่นห้องสาธารณะ?
A: เป็นบั๊กเก่าก่อน v9 ที่หักห้อง public ผิด — ปัจจุบันแก้แล้ว เฉพาะห้องส่วนตัวเท่านั้นที่หัก ค่าสร้างห้อง

Q: ดูเลขทศนิยมเยอะกว่า 2 ตำแหน่งได้ไหม?
A: ได้ — คลิกที่ตัวเลขใด ๆ ในตาราง เพื่อขยายจาก 2 ทศนิยม → 4 ทศนิยม (คลิกอีกครั้งคืน 2)