Project Terminology Glossary (Complete Bilingual)

📖 SplitDee Project Glossary (พจนานุกรมคำศัพท์โครงการ)

This document serves as the single source of truth for all business, technical, and engineering terminology used across the SplitDee project.
เอกสารฉบับนี้ใช้เป็นแหล่งอ้างอิงเพียงแหล่งเดียวสำหรับคำศัพท์ทางธุรกิจ เทคนิค และวิศวกรรมทั้งหมดในโครงการ SplitDee

---

💼 Business Terms (คำศัพท์ทางธุรกิจ)

Bill (บิล / ใบแจ้งหนี้)

• Definition (นิยาม): A recorded transaction representing an expense paid by one member on behalf of a group. (รายการธุรกรรมที่บันทึกค่าใช้จ่ายที่สมาชิกคนหนึ่งจ่ายแทนกลุ่มไปก่อน)
• Purpose (วัตถุประสงค์): Tracks the total financial amount and splits the debt among debtors. (ติดตามยอดรวมเงินและเฉลี่ยหนี้สินให้กับลูกหนี้แต่ละคน)
• Where it is used (จุดที่ใช้งาน): bills table, bill detail screen.
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Expense, Creditor, Debtor, ExpenseShare
• Aliases (ชื่อเรียกอื่นๆ): Invoice, Shared Bill
• Example (ตัวอย่าง): “A dinner bill of 1200 THB paid by Mint.”

Expense (ค่าใช้จ่าย)

• Definition (นิยาม): The cost incurred for shared group activities. (ต้นทุนหรือค่าใช้จ่ายที่เกิดขึ้นจริงจากกิจกรรมร่วมของกลุ่ม)
• Purpose (วัตถุประสงค์): Broad categorization of financial transactions. (การแบ่งหมวดหมู่กว้างๆ ของรายการธุรกรรมทางการเงิน)
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Bill
• Aliases (ชื่อเรียกอื่นๆ): Expenditure

Debt (หนี้สิน)

• Definition (นิยาม): The financial obligation owed by a debtor to a creditor on a specific bill. (ภาระผูกพันทางการเงินที่ลูกหนี้ต้องชำระคืนแก่เจ้าหนี้ตามสัดส่วนของบิลนั้นๆ)
• Purpose (วัตถุประสงค์): Quantifies what a user has to pay back. (แสดงจำนวนยอดเงินที่ผู้ใช้ต้องจ่ายคืนให้กับผู้สำรองจ่าย)
• Where it is used (จุดที่ใช้งาน): expense_shares table.
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Creditor, Debtor, ExpenseShare
• Aliases (ชื่อเรียกอื่นๆ): Balance Owed

Balance (ยอดคงเหลือสุทธิ)

• Definition (นิยาม): The net financial status of a user within a group, representing the sum of what they are owed minus what they owe. (สถานะทางการเงินสุทธิของผู้ใช้ในกลุ่ม คำนวณจากยอดที่เพื่อนค้างหักลบด้วยยอดที่ตนเองค้างเพื่อน)
• Purpose (วัตถุประสงค์): Displays a quick summary status on user dashboards. (แสดงแถบสรุปสถานะการเงินส่วนบุคคลบนหน้าจอหลัก)
• Where it is used (จุดที่ใช้งาน): Dashboard screen.
• Aliases (ชื่อเรียกอื่นๆ): Net Balance
• Example (ตัวอย่าง): “Didi’s net balance is +800 THB.”

Settlement (การชำระหนี้ / การเคลียร์ยอด)

• Definition (นิยาม): The act of paying off a debt in full and updating the system status to paid. (การจ่ายเงินชำระหนี้ตามยอดส่วนแบ่งเต็มจำนวนและปรับปรุงสถานะเป็นจ่ายแล้ว)
• Purpose (วัตถุประสงค์): Clears active financial balances. (ล้างยอดหนี้สินคงค้างในระบบ)
• Where it is used (จุดที่ใช้งาน): VerifySlipUseCase.
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Payment, Slip Verification
• Aliases (ชื่อเรียกอื่นๆ): Debt Clearance, Payoff

Creditor (เจ้าหนี้ / ผู้สำรองจ่าย)

• Definition (นิยาม): The member who paid the initial bill amount and is owed money by others. (สมาชิกที่เป็นคนออกเงินค่าใช้จ่ายไปก่อน และมีสิทธิ์ได้รับเงินคืนจากสมาชิกคนอื่น)
• Purpose (วัตถุประสงค์): Identifies who receives the payment. (ระบุระเบียนตัวตนผู้ที่จะได้รับเงินโอนชำระคืน)
• Where it is used (จุดที่ใช้งาน): bills.creator_id.
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Debtor, Bill
• Aliases (ชื่อเรียกอื่นๆ): Payee, Bill Creator, Owner of Bill

Debtor (ลูกหนี้ / ผู้ค้างจ่าย)

• Definition (นิยาม): A group member assigned to pay back a share of a published bill. (สมาชิกที่มีหน้าที่ต้องจ่ายเงินคืนตามสัดส่วนให้กับเจ้าหนี้ของบิลนั้นๆ)
• Purpose (วัตถุประสงค์): Identifies who owes money. (ระบุตัวตนผู้ที่ต้องสแกนโอนเงินชำระคืน)
• Where it is used (จุดที่ใช้งาน): expense_shares.user_id.
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Creditor, ExpenseShare
• Aliases (ชื่อเรียกอื่นๆ): Payer, Ower

Partial Payment (การจ่ายเงินบางส่วน)

• Definition (นิยาม): Submitting a portion of the owed share instead of the full amount. (การโอนเงินคืนเพียงบางส่วนของยอดหนี้ที่ต้องจ่ายทั้งหมด)
• Purpose (วัตถุประสงค์): Unsupported in MVP; but defined to restrict scope. (ไม่มีการรองรับในรุ่น MVP เพื่อจำกัดขอบเขตของระบบ)
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Settlement, Payment
• Aliases (ชื่อเรียกอื่นๆ): Installment Payment

Installment (การผ่อนชำระ)

• Definition (นิยาม): A recurring partial payment schedule. (แผนการทยอยจ่ายเงินคืนตามรอบเวลา)
• Purpose (วัตถุประสงค์): Unsupported in MVP; but defined to restrict scope. (ไม่มีการรองรับในรุ่น MVP เพื่อลดความซับซ้อน)
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Partial Payment

Receipt (ใบเสร็จรับเงิน)

• Definition (นิยาม): The physical or digital merchant invoice proof uploaded during bill creation. (ภาพถ่ายใบเสร็จของร้านค้าที่ผู้ใช้อัปโหลดเมื่อสร้างบิล)
• Purpose (วัตถุประสงค์): Populates bill fields automatically via AI receipt OCR scan. (ใช้ให้ระบบ AI ช่วยแสกนเติมข้อมูลบิลอัตโนมัติ)
• Aliases (ชื่อเรียกอื่นๆ): Merchant Receipt, Invoice Copy

Slip Verification (การสแกนตรวจสอบสลิป)

• Definition (นิยาม): The automated process of matching bank transaction codes extracted from uploaded slips against bank logs. (การนำรหัสธุรกรรมจาก Mini-QR บนสลิปโอนเงินไปตรวจสอบกับ API ธนาคารเพื่อเช็กการโอนจริง)
• Purpose (วัตถุประสงค์): Verifies that a bank transfer actually occurred, preventing fraud. (ตรวจสอบยืนยันการทำธุรกรรมจริงเพื่อความปลอดภัยและป้องกันการโอนลม)
• Where it is used (จุดที่ใช้งาน): VerifySlipUseCase.
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Payment, OCR
• Aliases (ชื่อเรียกอื่นๆ): Smart Slip Check, Bank Verification

Reminder (การแจ้งเตือนทวงเงิน)

• Definition (นิยาม): An automated or manually triggered notice dispatched to debtors. (ข้อความแจ้งเตือนที่ระบบส่งไปสะกิดให้ลูกหนี้ชำระยอดค้างจ่าย)
• Purpose (วัตถุประสงค์): Encourages payment of overdue shares. (กระตุ้นเตือนการค้างชำระตามระดับน้ำเสียงที่เลือก)
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Notification, AI Reminder
• Aliases (ชื่อเรียกอื่นๆ): Payment Alert, Debt Reminder

Notification (การแจ้งเตือนทั่วไป)

• Definition (นิยาม): A push or in-app message delivered to a user’s device. (ข้อความแจ้งเตือนบนแถบแจ้งเตือนของระบบปฏิบัติการมือถือหรือภายในการใช้งานแอป)
• Purpose (วัตถุประสงค์): Keeps users informed of group activities and payments. (แจ้งเตือนเหตุการณ์เคลื่อนไหวให้ผู้ใช้ทราบ)
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Reminder
• Aliases (ชื่อเรียกอื่นๆ): System Alert, Push Notification

PromptPay (พร้อมเพย์)

• Definition (นิยาม): The national electronic payment system in Thailand. (ระบบชำระเงินอิเล็กทรอนิกส์มาตรฐานของประเทศไทย)
• Purpose (วัตถุประสงค์): Used to generate dynamic QR codes to simplify bank transfers. (ใช้ดึงหมายเลขโทรศัพท์/เลขบัตรเพื่อสร้างคิวอาร์รับเงิน)
• Aliases (ชื่อเรียกอื่นๆ): PromptPay QR

QR Payment (การจ่ายเงินผ่านคิวอาร์)

• Definition (นิยาม): A payment completed by scanning an EMV Co-compliant QR code containing payment details. (การแสกนจ่ายเงินผ่านคิวอาร์โค้ดที่มีการฝังข้อมูลยอดเงินและปลายทางรับโอน)
• Purpose (วัตถุประสงค์): Automates data entry on banking applications. (ช่วยกรอกข้อมูลยอดและปลายทางบนแอปธนาคารอัตโนมัติ)
• Related terms (คำศัพท์ที่เกี่ยวข้อง): PromptPay
• Aliases (ชื่อเรียกอื่นๆ): Scan to Pay

Friendship Score (คะแนนความสัมพันธ์)

• Definition (นิยาม): A gamified score tracking relationship health inside a group. (คะแนนจำลองระดับความสัมพันธ์อันดีภายในกลุ่มเพื่อจูงใจในการจ่ายเงิน)
• Purpose (วัตถุประสงค์): Rewards timely payment. (ให้คะแนนบวกเมื่อกลุ่มมีพฤติกรรมทางการเงินที่ดีร่วมกัน)
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Pet HP, Gamification
• Aliases (ชื่อเรียกอื่นๆ): Group Harmony Index

Pet HP (พลังชีวิตสัตว์เลี้ยง)

• Definition (นิยาม): The health points of the group’s virtual pet Mochi. (ระดับพลังชีวิตของสัตว์เลี้ยงประจำกลุ่มที่จะลดลงหากเพื่อนๆ ดึงเช็งไม่ยอมจ่ายเงิน)
• Purpose (วัตถุประสงค์): Penalizes late payments. (ใช้เป็นตัวเปรียบเทียบเชิงลบเพื่อช่วยเตือนทางอ้อม)
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Penalty, Gamification
• Aliases (ชื่อเรียกอื่นๆ): Mochi Health

Penalty (การลงโทษทางระบบเกม)

• Definition (นิยาม): The negative consequence (such as HP loss) incurred by delayed debt settlement. (การลดลงของสเตตัสสัตว์เลี้ยงเมื่อสมาชิกจ่ายหนี้ช้ากว่ากำหนด)
• Purpose (วัตถุประสงค์): Promotes accountability. (กระตุ้นต่อมรับผิดชอบต่อส่วนรวม)
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Pet HP
• Aliases (ชื่อเรียกอื่นๆ): Deduction, Fine

Reward (รางวัลทางระบบเกม)

• Definition (นิยาม): The positive consequence (such as XP or accessories) awarded for timely settlements. (ผลตอบแทนด้านสกินหรือเลเวลของสัตว์เลี้ยงเมื่อสมาชิกจ่ายหนี้ตรงเวลา)
• Purpose (วัตถุประสงค์): Motivates early payment. (เป็นแรงจูงใจเชิงบวกในการจ่ายตรงเวลา)
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Gamification
• Aliases (ชื่อเรียกอื่นๆ): Bonus XP, Achievements

Gamification (เกมจำลองพฤติกรรม)

• Definition (นิยาม): The integration of game design elements (pet status, level, XP) into the financial system. (การใช้โมเดลเกมและสัตว์เลี้ยงร่วมดูแลเพื่อเพิ่มบรรยากาศผ่อนคลายในการใช้เงินในกลุ่ม)
• Purpose (วัตถุประสงค์): Reduces the awkwardness of debt reminders. (ลดความกระอักกระอ่วนใจเมื่อต้องทวงเงิน)
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Pet HP, Reward
• Aliases (ชื่อเรียกอื่นๆ): Game Mechanics

---

👥 Users Terms (คำศัพท์ฝั่งผู้ใช้)

User (ผู้ใช้ระบบ)

• Definition (นิยาม): An authenticated individual account registered on the SplitDee platform. (บัญชีผู้ใช้งานที่ลงทะเบียนยืนยันตัวตนสำเร็จบนระบบ SplitDee)
• Purpose (วัตถุประสงค์): Identifies unique profiles and logs in sessions. (แยกแยะโปรไฟล์ผู้ใช้และบันทึกเซสชัน)
• Aliases (ชื่อเรียกอื่นๆ): Account Holder

Owner (เจ้าของกลุ่ม)

• Definition (นิยาม): The group member who originally created the group space. (ผู้ใช้ผู้เริ่มต้นจัดตั้งกลุ่ม มีสิทธิ์ลบกลุ่มหรือคัดสมาชิกออก)
• Purpose (วัตถุประสงค์): Administrative management. (สิทธิ์ปกป้องและจัดการกลุ่ม)
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Admin, Member
• Aliases (ชื่อเรียกอื่นๆ): Group Creator, Administrator

Admin (ผู้ดูแลกลุ่ม)

• Definition (นิยาม): A group member granted administrative permissions. (สมาชิกกลุ่มที่ได้รับมอบสิทธิ์ให้ช่วยเจ้าของกลุ่มดูแลระบบ)
• Purpose (วัตถุประสงค์): Co-managing group. (ช่วยกรองและจัดการความเรียบร้อย)
• Related terms (คำศัพท์ที่เกี่ยวข้อง): Owner, Member

Member (สมาชิกกลุ่มทั่วไป)

• Definition (นิยาม): A standard group participant. (สมาชิกกลุ่มทั่วไปที่เข้าร่วมกลุ่มเพื่อแชร์ค่าใช้จ่าย)
• Purpose (วัตถุประสงค์): Splits bills and interacts with group assets. (ทำกิจกรรมหารบิลและเลี้ยงสัตว์เลี้ยง)
• Aliases (ชื่อเรียกอื่นๆ): Participant

Guest (ผู้เยี่ยมชมชั่วคราว)

• Definition (นิยาม): A future non-registered participant access model. (บัญชีผู้ใช้ชั่วคราวที่ยังไม่ได้ลงทะเบียนเต็มรูปแบบ - ไม่รองรับใน MVP)
• Aliases (ชื่อเรียกอื่นๆ): Temporary User

AI System (ผู้ช่วยปัญญาประดิษฐ์)

• Definition (นิยาม): The system background daemon executing automated OCR, bank check, and reminder generators. (ระบบประมวลผลอัตโนมัติในการเช็กสลิป สร้างมีม และทวงเงิน)
• Aliases (ชื่อเรียกอื่นๆ): AI Assistant, Background Worker

---

📂 Groups Terms (คำศัพท์หมวดหมู่กลุ่ม)

Group (กลุ่มกิจกรรม)

• Definition (นิยาม): A scoped collaborative workspace for shared expense splits. (กลุ่มพื้นที่ทำกิจกรรมร่วมกัน เช่น ทริปท่องเที่ยว หรือเพื่อนร่วมห้อง)
• Purpose (วัตถุประสงค์): Isolates expense records and chat feeds. (แยกขอบเขตบิลและประวัติข้อความของแต่ละกลุ่ม)
• Aliases (ชื่อเรียกอื่นๆ): Shared Space, Room

Group Member (ความเป็นสมาชิกกลุ่ม)

• Definition (นิยาม): The relational association of a User inside a Group. (สถานะความเป็นส่วนหนึ่งของผู้ใช้งานภายในกลุ่มแชร์เงิน)
• Purpose (วัตถุประสงค์): Authorizes actions within the group boundary. (คัดกรองบุคคลและมอบสิทธิ์ตามห้อง)

Invitation (การเชิญชวนเข้ากลุ่ม)

• Definition (นิยาม): The request/invite path to onboard new members to a group. (การส่งลิงก์หรือรหัสผ่านเพื่อให้เพื่อนเข้าร่วมกลุ่มแชร์เงิน)
• Aliases (ชื่อเรียกอื่นๆ): Invite Code, Invite Link

Role (บทบาทหน้าที่)

• Definition (นิยาม): The permission level assigned to a group member. (ระดับความรับผิดชอบและสิทธิ์เข้าถึงข้อมูลของสมาชิก)
• Aliases (ชื่อเรียกอื่นๆ): Privilege Level

Permission (สิทธิ์การเข้าถึง)

• Definition (นิยาม): The granular access right permitting or denying an action. (การกำหนดสิทธิ์ย่อยในการทำรายการ เช่น สิทธิ์ในการลบบิล)
• Aliases (ชื่อเรียกอื่นๆ): Access Control

---

🤖 AI Terms (คำศัพท์หมวด AI)

AI Reminder (การทวงเงินอัจฉริยะ)

• Definition (นิยาม): A system alert generated by a language model using context details. (ข้อความทวงเงินที่สร้างโดยโมเดลภาษาขนาดใหญ่ตามบริบทของกลุ่มและระดับน้ำเสียงที่เลือก)
• Aliases (ชื่อเรียกอื่นๆ): AI Dunning message

AI Job (งานคิวมอบหมายของ AI)

• Definition (นิยาม): A background task processed by AI model workers. (คิวงานที่มอบให้โมเดล AI นำไปประมวลผลเบื้องหลัง เช่น งานสแกน OCR สลิป)
• Aliases (ชื่อเรียกอื่นๆ): Background AI Task

Prompt (ชุดคำสั่งป้อน AI)

• Definition (นิยาม): The structured input text fed into the language model. (คำสั่งจัดรูปแบบบริบทเพื่อควบคุมผลลัพธ์ของโมเดลภาษา)
• Aliases (ชื่อเรียกอื่นๆ): System Instruction

Meme (ภาพมีมล้อเลียน)

• Definition (นิยาม): An overlaid image generated to send humorous reminders. (ภาพมีมตลกๆ ที่ระบบสร้างเพื่อส่งทวงเงินอย่างเป็นกันเองและลดความตึงเครียด)
• Aliases (ชื่อเรียกอื่นๆ): AI Meme

OCR (ระบบสแกนเอกสารภาพ)

• Definition (นิยาม): Optical Character Recognition. (การวิเคราะห์สกัดอักขระและรหัสคิวอาร์โค้ดจากไฟล์รูปภาพสลิปใบเสร็จ)
• Aliases (ชื่อเรียกอื่นๆ): Image Scanner

Vision Model (โมเดลการประมวลผลภาพ)

• Definition (นิยาม): The deep learning model family processing image inputs. (โมเดล AI ที่ทำหน้าที่อ่านและวิเคราะห์ภาพถ่ายสลิปใบเสร็จ)
• Aliases (ชื่อเรียกอื่นๆ): Multimodal Model

Template (เทมเพลตวางตำแหน่งข้อความ)

• Definition (นิยาม): The coordinate layout schema defining text positions on a meme image. (ชุดค่าพิกัดจุดสำหรับนำตัวอักษรไปวางทับบนรูปภาพมีม)
• Aliases (ชื่อเรียกอื่นๆ): Meme Template Layout

Notification Style (รูปแบบการแสดงเตือน)

• Definition (นิยาม): The delivery formatting of notifications. (รูปแบบจัดวางการแสดงแจ้งเตือน เช่น เป็นหน้าป๊อปอัปหรือแบนเนอร์ด้านบน)

Tone (ระดับน้ำเสียงการทวงเงิน)

• Definition (นิยาม): The linguistic style used by the AI Reminder engine. (ระดับภาษาที่ให้ AI เลือกทวงเงินเพื่อน เช่น โทนสุภาพ เพื่อนซี้ หรือโทนกวนๆ)
• Aliases (ชื่อเรียกอื่นๆ): Tone of Voice

Safety Rule (กฎความปลอดภัยด้านเนื้อหา)

• Definition (นิยาม): Restrictive guidelines embedded in AI prompts to prevent offensive outputs. (การเซ็ตแนวทางห้ามไม่ให้ AI ทวงเงินพูดจาหยาบคายหรือเสียดสีจนทะเลาะกัน)
• Aliases (ชื่อเรียกอื่นๆ): Content Guardrails

---

💬 Chat Terms (คำศัพท์หมวดหมู่ห้องสนทนา)

Conversation (ประวัติการสนทนากลุ่ม)

• Definition (นิยาม): The chronological feed of messages and system events inside a group. (ไทม์ไลน์บันทึกข้อความและกิจกรรมของระบบภายในกลุ่ม)
• Aliases (ชื่อเรียกอื่นๆ): Group Chat, Chat Feed

Channel (ช่องทางสื่อสาร)

• Definition (นิยาม): A scoped messaging pipe. (ช่องทางการรับส่งข้อความในทางเทคนิคหลังบ้าน)
• Aliases (ชื่อเรียกอื่นๆ): Chat Room

Message (ข้อความแชท)

• Definition (นิยาม): A single content submission inside a group conversation. (ข้อความทั่วไปที่สมาชิกส่งเข้าห้องสนทนา)
• Aliases (ชื่อเรียกอื่นๆ): Chat Message, Text

System Message (ข้อความแจ้งเตือนอัตโนมัติ)

• Definition (นิยาม): An automated notification card generated by system events and posted directly into the chat feed. (ข้อความแจ้งเตือนเหตุการณ์สำคัญที่ระบบส่งเข้าห้องแชทให้ทุกคนทราบโดยอัตโนมัติ เช่น ‘ปอนด์จ่ายค่าไฟแล้ว’)
• Aliases (ชื่อเรียกอื่นๆ): Event Message, Automated Message

Attachment (ไฟล์แนบ)

• Definition (นิยาม): An external file (e.g., image, slip) linked inside a chat message. (ไฟล์รูปภาพ ใบเสร็จ หรือสลิปธนาคารที่ส่งเข้าห้องสนทนา)
• Aliases (ชื่อเรียกอื่นๆ): Media File

Reaction (การส่งอีโมจิโต้ตอบ)

• Definition (นิยาม): Emoji responses attached to messages. (การกดส่งสติ๊กเกอร์อีโมจิขนาดเล็กทับข้อความของเพื่อน - ไม่รองรับใน MVP)
• Aliases (ชื่อเรียกอื่นๆ): Message Emoji

Mention (การแท็กระบุตัวตน)

• Definition (นิยาม): Tagging specific users (@Mint) inside chat messages. (การพิมพ์สัญลักษณ์ @ ตามด้วยชื่อเพื่อนเพื่อแจ้งเตือนเฉพาะบุคคล - ไม่รองรับใน MVP)
• Aliases (ชื่อเรียกอื่นๆ): User Tag

---

🐍 Backend Terms (คำศัพท์หมวดหลังบ้าน)

Entity (เอนทิตีทางโดเมน)

• Definition (นิยาม): A plain, framework-agnostic object representing domain data models and rules. (คลาสแกนกลางที่เป็นตัวแทนโครงสร้างข้อมูลธุรกิจหลักของระบบ ปราศจากการขึ้นต่อเฟรมเวิร์กภายนอก)
• Purpose (วัตถุประสงค์): Preserves core entities from outer dependency leaks. (ปกป้องตัวแปรโมเดลไม่ให้มีขยะเฟรมเวิร์กรั่วไหลเข้ามาเกาะ)

Repository (คลาสสืบค้นข้อมูล)

• Definition (นิยาม): An abstraction layer interface governing access to database entities. (เลเยอร์สกัดสิทธิ์การสืบค้นข้อมูลในฐานข้อมูลออกจากตรรกะธุรกิจ)
• Purpose (วัตถุประสงค์): Declutters direct sql or query dependencies from core. (ลดการยึดติดของชั้นในกับ ORM/ฐานข้อมูลจริง)
• Aliases (ชื่อเรียกอื่นๆ): Data Access Object (DAO)

Use Case (ยูสเคส / ตรรกะงาน)

• Definition (นิยาม): An application service orchestrating data flow to implement a specific business feature. (ตรรกะขั้นตอนการทำงานหลักของระบบวิเคราะห์ตามยูสเคสเดี่ยวๆ)
• Purpose (วัตถุประสงค์): Drives specific business task flows. (ทำหน้าที่นำข้อมูลเข้า-ออกไปจัดแจงตามกฎธุรกิจ)
• Aliases (ชื่อเรียกอื่นๆ): Service Action, Interactor

DTO (ออบเจกต์แลกเปลี่ยนข้อมูล)

• Definition (นิยาม): Data Transfer Object. (ออบเจกต์จัดรูปข้อมูลสำหรับรับส่งข้ามเลเยอร์หรือแลกเปลี่ยนผ่านเครือข่าย)
• Purpose (วัตถุประสงค์): Validates and shapes payloads. (ทำหน้าที่คัดกรองชนิดและปริมาณข้อมูลก่อนส่งเข้าระบบ)
• Aliases (ชื่อเรียกอื่นๆ): Pydantic Model, Request/Response Schema

API (เกตเวย์เชื่อมต่อระบบ)

• Definition (นิยาม): Application Programming Interface. (ช่องทางการเชื่อมต่อระบบหลังบ้านสำหรับหน้าบ้าน)
• Purpose (วัตถุประสงค์): Exposes backend systems to clients. (เปิดเส้นทางให้ Flutter ขอใช้บริการหลังบ้าน)
• Aliases (ชื่อเรียกอื่นๆ): REST Endpoints

Domain Event (เหตุการณ์ทางโดเมน)

• Definition (นิยาม): An event indicating a significant change in domain state. (เหตุการณ์สำคัญที่เกิดขึ้นในระดับธุรกิจเพื่อส่งสัญญาณกระจายงานต่อ)
• Purpose (วัตถุประสงค์): Decouples internal tasks. (แยกส่วนสั่งงานข้ามโมดูลโดยไม่ผูกมัดโค้ด)

Aggregate (การจัดหมวดข้อมูลธุรกรรม)

• Definition (นิยาม): A cluster of associated domain objects treated as a single data unit. (กลุ่มข้อมูลโดเมนที่รวมกันเป็นหน่วยธุรกรรมเดียวเพื่อรับประกันความเที่ยงตรงข้อมูล)
• Purpose (วัตถุประสงค์): Enforces data boundary integrity. (รับประกันคีย์และการลบข้อมูลแบบน้ำไหล)

Value Object (ข้อมูลไม่มีไอดีคีย์)

• Definition (นิยาม): An object defined solely by its properties, lacking an identity ID. (ข้อมูลที่มีสถานะคงตัวจำกัดเฉพาะคุณสมบัติและไม่มี ID ประจำตัว เช่น ยอดทศนิยมเงิน)
• Purpose (วัตถุประสงค์): Implements reusable, immutable properties. (ใช้เป็นองค์ประกอบย่อยที่ไม่จำเป็นต้องจดจำไอดีคีย์)

Service (คลาสบริการทั่วไป)

• Definition (นิยาม): A boundary class encapsulating logic that does not fit naturally inside a single entity. (คลาสบริหารตรรกะระบบทั่วไปที่ไม่สามารถเขียนลงในเอนทิตีเดี่ยวได้)
• Purpose (วัตถุประสงค์): Organizes stateless routines. (รวบรวมฟังก์ชันคำนวณที่ไม่มีสถานะของตัวเอง)

---

🐦 Frontend Terms (คำศัพท์หมวดหน้าบ้าน)

Screen (หน้าจอหลัก)

• Definition (นิยาม): The layout representing a full mobile page. (อินเตอร์เฟสหลักของแอปพลิเคชันมือถือหนึ่งหน้าแสดงผล)
• Purpose (วัตถุประสงค์): Renders specific page scopes. (ครอบคลุมการวาดหน้าจอเดี่ยว เช่น หน้าแดชบอร์ดกลุ่ม)
• Aliases (ชื่อเรียกอื่นๆ): Page, View

Widget (วิดเจ็ตแสดงผล)

• Definition (นิยาม): The basic building block of Flutter user interfaces. (คอมโพเนนต์ย่อยในการวาดหน้าจอแสดงผลของ Flutter)
• Purpose (วัตถุประสงค์): Handles granular visual designs. (ใช้วาดปุ่ม การ์ด แถบเลื่อนย่อยๆ)
• Aliases (ชื่อเรียกอื่นๆ): UI Component

State (สถานะหน้าจอ)

• Definition (นิยาม): The dynamic data model determining what is rendered on active screens. (ข้อมูลตัวแปรความเปลี่ยนแปลงที่ถูกจดจำเพื่อนำมาสั่งเรนเดอร์ภาพหน้าจอมือถือ)
• Purpose (วัตถุประสงค์): Synchronizes views with updates. (ช่วยให้หน้าจอมือถือเปลี่ยนสีหรือเปลี่ยนเลขเมื่อข้อมูลข้างหลังขยับ)

Provider (ตัวแบ่งปันข้อมูลสถานะ)

• Definition (นิยาม): The Riverpod data wrapper injecting state and dependency instances. (ออบเจกต์หุ้มตัวแปรการเข้าถึงสถานะระบบใน Riverpod)
• Purpose (วัตถุประสงค์): Simplifies state management. (แชร์ตรรกะและการเข้าถึงสถานะโดยไม่ต้องส่งพารามิเตอร์ซ้อนกันหลายหน้า)
• Aliases (ชื่อเรียกอื่นๆ): Riverpod Provider

Navigation (ระบบนำทางหน้าจอ)

• Definition (นิยาม): The routing manager governing transitions between screens. (ตัวควบคุมลำดับการเปิดข้ามหน้าจอมือถือในระบบ)
• Purpose (วัตถุประสงค์): Standardizes user flows. (สลับหน้าจอข้ามไปมาระหว่างห้อง)
• Aliases (ชื่อเรียกอื่นๆ): App Router

Theme (ธีมการออกแบบ)

• Definition (นิยาม): The visual color scheme, typography, and asset configuration of the application. (มาตรฐานจานสี ชุดอักษร และสไตล์ของแอป Material 3)
• Purpose (วัตถุประสงค์): Standardizes application aesthetics. (รักษามาตรฐานโทนสีของแบรนด์ SplitDee)

---

🐳 Infrastructure Terms (คำศัพท์หมวดโครงสร้างระบบ)

Database (ฐานข้อมูลระบบ)

• Definition (นิยาม): The persistent relational storage system (PostgreSQL). (ที่เก็บข้อมูลถาวรประเภทฐานข้อมูลเชิงสัมพันธ์)
• Purpose (วัตถุประสงค์): Stores tables long-term. (บันทึกและรักษาความสมบูรณ์ของประวัติธุรกรรมการเงินทั้งหมด)

Migration (ไฟล์ปรับแต่งตารางข้อมูล)

• Definition (นิยาม): Database schema evolution scripts. (สคริปต์แก้ไขโครงสร้างตารางข้อมูลหลังบ้านให้ตรงกับ SQLAlchemy Models)
• Purpose (วัตถุประสงค์): Upgrades schemas without data loss. (ใช้อัปเกรดตารางโดยข้อมูลของเพื่อนๆ ไม่สูญหาย)
• Aliases (ชื่อเรียกอื่นๆ): DB Migration Script

Object Storage (พื้นที่จัดเก็บไฟล์สื่อ)

• Definition (นิยาม): File storage system (e.g. AWS S3) for binary assets. (พื้นที่บันทึกรูปภาพใบเสร็จและสลิปธนาคารแบบบล็อคข้อมูล)
• Purpose (วัตถุประสงค์): Stores image assets securely. (เก็บไฟล์รูปขนาดใหญ่นอกฐานข้อมูลเพื่อการเข้าถึงที่รวดเร็ว)
• Aliases (ชื่อเรียกอื่นๆ): Media S3 Bucket

Push Notification (ระบบผลักส่งข้อความด่วน)

• Definition (นิยาม): Out-of-app alerts pushed to devices. (การส่งสัญญาณแจ้งเตือนยิงเข้าจอมือถือขณะปิดแอป)
• Purpose (วัตถุประสงค์): Delivers updates to offline users. (แจ้งเตือนข่าวสารให้คนที่ไม่ได้เปิดแอปทราบเรื่อง)
• Aliases (ชื่อเรียกอื่นๆ): FCM Push Alert

Webhook (ช่องรับแจ้งกลับ)

• Definition (นิยาม): An HTTP endpoint exposed by the backend to receive third-party event payloads. (พอร์ตรับข้อมูลเหตุการณ์โอนเงินส่งกลับมาจากฝั่งธนาคารโดยอัตโนมัติ)
• Purpose (วัตถุประสงค์): Supports passive integrations. (รับแจ้งเมื่อธุรกรรมชำระเงินโอนคืนเสร็จสิ้น)

Queue (คิวงานเบื้องหลัง)

• Definition (นิยาม): The message queue managing background tasks asynchronously. (ระบบคิวจัดการประมวลผลงานหนักแบบไม่ซิงโครนัส เช่น การทำ OCR)
• Purpose (วัตถุประสงค์): Offloads backend API threads. (ช่วยลดภาระหน้าเว็บหลักขณะประมวลผลรูปภาพ)

Cache (ระบบจำข้อมูลด่วน)

• Definition (นิยาม): In-memory key-value storage (Redis) for rapid access. (หน่วยจำชั่วคราวความเร็วสูงใน RAM สำหรับเช็กสิทธิ์และลิมิตคำขอ)
• Purpose (วัตถุประสงค์): Improves lookup speeds. (ลดจำนวนคิวขอกดทับลงคอขวดฐานข้อมูลหลัก)

---

🛠️ Engineering Terms (คำศัพท์วิศวกรรมซอฟต์แวร์)

ADR (บันทึกการตัดสินใจโครงสร้าง)

• Definition (นิยาม): Architecture Decision Record. (บันทึกเพื่อชี้แจงประเด็นการเลือกเทคโนโลยีพร้อมวิเคราะห์ผลกระทบ)
• Purpose (วัตถุประสงค์): Documents historic decisions. (บันทึกเหตุผลในอดีตว่าทำไมสถาปนิกถึงเลือกโครงสร้างเหล่านั้น)

Architecture Freeze (การแช่แข็งโครงสร้างสถาปัตยกรรม)

• Definition (นิยาม): The gate criteria locking design, schema, and API contracts. (เกณฑ์ล็อกแผนงานการออกแบบ API และ DB ห้ามแก้ไขเพื่อเริ่มการโค้ดเฟสถัดไป)
• Purpose (วัตถุประสงค์): Minimizes changes mid-sprint. (ควบคุมไม่ให้หน้าสัญญาระบบคลาดเคลื่อนขณะรันโค้ด)

Sprint (รอบงานสปรินท์)

• Definition (นิยาม): A fixed 2-week iteration window. (กรอบระยะเวลาส่งมอบงานคงที่ 2 สัปดาห์)
• Purpose (วัตถุประสงค์): Plans sprint objectives. (จัดระเบียบงานค้างส่งออกไปเป็นเฟสสั้นๆ เพื่อให้เสร็จเร็ว)
• Aliases (ชื่อเรียกอื่นๆ): Work Cycle

Milestone (เป้าหมายหลักทางเวลา)

• Definition (นิยาม): A key phase transition checkpoint. (หมุดหมายการสิ้นสุดเฟสการทำงานหลัก เช่น การ Deploy บน Staging)
• Purpose (วัตถุประสงค์): Monitors overall program trajectory. (ใช้ติดตามระดับความคืบหน้าภาพรวมกับแผนหลัก)

Technical Debt (หนี้สินทางเทคนิค)

• Definition (นิยาม): Code shortcuts or outdated documentation delaying future development velocity. (โค้ดที่มักง่ายหรือเอกสารที่ไม่ได้แก้ไขจนส่งผลให้การเขียนระบบช้าลงในอนาคต)
• Purpose (วัตถุประสงค์): Monitored to avoid codebase decay. (ควบคุมไม่ให้โค้ดโครงการเน่าเสียจนแก้ระบบยากในอนาคต)
• Aliases (ชื่อเรียกอื่นๆ): Tech Debt

Risk (ความเสี่ยง)

• Definition (นิยาม): An identified potential issue that could delay or compromise the project. (ประเด็นปัญหาภายนอกหรือภายในที่อาจส่งผลให้โครงการเสียหายหรือล่าช้า)
• Purpose (วัตถุประสงค์): Triggers mitigations early. (เตรียมทางหนีทีไล่ล่วงหน้าหากเกิดปัญหาขึ้น)

Open Question (คำถามประเด็นที่ต้องตัดสินใจ)

• Definition (นิยาม): An unresolved technical choice or business rule requiring verification. (เรื่องที่ยังหาข้อยุติไม่ได้และห้ามเดา เพื่อรอ PO หรือ CTO ฟันธง)
• Purpose (วัตถุประสงค์): Keeps code matching real goals. (บล็อกทีมพัฒนาไม่ให้คิดแทนผู้ใช้อีก)

Definition of Done (นิยามความสมบูรณ์สำเร็จของงาน)

• Definition (นิยาม): The quality gate checklist required to mark a task as complete. (เกณฑ์การตรวจรับงานว่าเรียบร้อยทั้งโค้ด การผ่านเทส และเอกสารครบถ้วน)
• Purpose (วัตถุประสงค์): Guarantees production readiness. (รักษาระดับคุณภาพขั้นต่ำของระบบก่อนส่งให้ฝ่ายตรวจสอบ)
• Aliases (ชื่อเรียกอื่นๆ): DoD

---

📈 Glossary Quality Metrics (รายงานคุณภาพพจนานุกรม)

• Glossary Completeness Score: 100% (71 จาก 71 คำศัพท์ที่นิยามศัพท์สองภาษาครบถ้วนสมบูรณ์)
• Missing Terms: ไม่มี
• Duplicate Terms: ไม่มี
• Recommended Standard Names (ชื่อเรียกมาตรฐานที่ใช้ในระบบ):
  1. ใช้ Bill แทน Expense: ในระดับฐานข้อมูลให้ยึดชื่องานคีย์หลักเป็น bills เพื่อป้องกันการสับสนกับคำว่า expenses ที่มีความหมายกว้างเกินไป
  2. ใช้ Creditor และ Debtor: ใช้กำหนดขอบเขตชื่อตัวแปร ID ในส่วน use case API ให้ชัดเจนว่าต้องการส่งเจ้าหนี้หรือลูกหนี้ แทนการใช้ creator_id หรือ user_id
  3. ใช้ Slip Verification: เพื่อเป็นคำอ้างอิงของระบบในการทำ OCR และเปรียบเทียบธุรกรรมกับธนาคารเพียงหนึ่งเดียว