472 lines
5.3 KiB
Markdown
472 lines
5.3 KiB
Markdown
# Task UX.1: Thai CRM Terminology Standardization
|
|
|
|
## Goal
|
|
|
|
สร้างมาตรฐานคำศัพท์ภาษาไทยสำหรับ ALLA OS CRM
|
|
|
|
เพื่อให้:
|
|
|
|
* Menu
|
|
* Form
|
|
* Detail Page
|
|
* Dashboard
|
|
* Report
|
|
* PDF
|
|
* Approval Workflow
|
|
|
|
ใช้ภาษาธุรกิจชุดเดียวกัน
|
|
|
|
หลัง Task นี้
|
|
|
|
Terminology ถือว่า Frozen
|
|
|
|
การเปลี่ยนคำในอนาคตต้องผ่าน ADR หรือ Business Review
|
|
|
|
---
|
|
|
|
# Background
|
|
|
|
CRM ได้ผ่าน
|
|
|
|
```txt
|
|
Task D
|
|
Task E
|
|
Task F
|
|
Task G
|
|
Task H
|
|
Task I
|
|
Task J
|
|
```
|
|
|
|
แล้ว
|
|
|
|
ปัจจุบันมีการใช้คำผสมกัน:
|
|
|
|
```txt
|
|
Lead
|
|
Enquiry
|
|
Opportunity
|
|
Quotation
|
|
Customer
|
|
Project Party
|
|
Billing Customer
|
|
```
|
|
|
|
ซึ่งอาจสร้างความสับสนให้ผู้ใช้งาน
|
|
|
|
โดยเฉพาะ:
|
|
|
|
```txt
|
|
Marketing
|
|
Sales
|
|
Manager
|
|
Admin
|
|
```
|
|
|
|
---
|
|
|
|
# Scope UX.1.1 Terminology Registry
|
|
|
|
Create:
|
|
|
|
```txt
|
|
docs/business/crm-terminology.md
|
|
```
|
|
|
|
Document format:
|
|
|
|
| Code | English | Thai | Notes |
|
|
| ---- | ------- | ---- | ----- |
|
|
|
|
This file becomes the source of truth.
|
|
|
|
---
|
|
|
|
# Scope UX.1.2 Frozen CRM Business Terms
|
|
|
|
## CRM
|
|
|
|
Keep:
|
|
|
|
```txt
|
|
CRM
|
|
```
|
|
|
|
Do not translate.
|
|
|
|
---
|
|
|
|
## Dashboard
|
|
|
|
Keep:
|
|
|
|
```txt
|
|
Dashboard
|
|
```
|
|
|
|
---
|
|
|
|
## Lead
|
|
|
|
Display:
|
|
|
|
```txt
|
|
ลีด
|
|
```
|
|
|
|
Definition:
|
|
|
|
```txt
|
|
ข้อมูลลูกค้าเป้าหมายก่อนส่งต่อให้ฝ่ายขาย
|
|
```
|
|
|
|
---
|
|
|
|
## Enquiry
|
|
|
|
Display:
|
|
|
|
```txt
|
|
โอกาสขาย
|
|
```
|
|
|
|
Definition:
|
|
|
|
```txt
|
|
โอกาสทางการขายที่ได้รับมอบหมายให้ฝ่ายขายดำเนินการ
|
|
```
|
|
|
|
---
|
|
|
|
## Quotation
|
|
|
|
Display:
|
|
|
|
```txt
|
|
ใบเสนอราคา
|
|
```
|
|
|
|
---
|
|
|
|
## Approval
|
|
|
|
Display:
|
|
|
|
```txt
|
|
อนุมัติเอกสาร
|
|
```
|
|
|
|
---
|
|
|
|
## Customer
|
|
|
|
Display:
|
|
|
|
```txt
|
|
ลูกค้า
|
|
```
|
|
|
|
---
|
|
|
|
## Contact
|
|
|
|
Display:
|
|
|
|
```txt
|
|
ผู้ติดต่อ
|
|
```
|
|
|
|
---
|
|
|
|
## Billing Customer
|
|
|
|
Display:
|
|
|
|
```txt
|
|
ลูกค้าผู้รับใบเสนอราคา
|
|
```
|
|
|
|
Definition:
|
|
|
|
```txt
|
|
บริษัทที่ใช้สำหรับออกใบเสนอราคาและวางบิล
|
|
```
|
|
|
|
---
|
|
|
|
## Project Parties
|
|
|
|
Display:
|
|
|
|
```txt
|
|
ผู้เกี่ยวข้องในโครงการ
|
|
```
|
|
|
|
---
|
|
|
|
# Scope UX.1.3 Project Party Roles
|
|
|
|
## customer
|
|
|
|
Display:
|
|
|
|
```txt
|
|
ลูกค้า
|
|
```
|
|
|
|
---
|
|
|
|
## billing_customer
|
|
|
|
Display:
|
|
|
|
```txt
|
|
ลูกค้าผู้รับใบเสนอราคา
|
|
```
|
|
|
|
---
|
|
|
|
## end_customer
|
|
|
|
Display:
|
|
|
|
```txt
|
|
เจ้าของโครงการ
|
|
```
|
|
|
|
---
|
|
|
|
## contractor
|
|
|
|
Display:
|
|
|
|
```txt
|
|
ผู้รับเหมา
|
|
```
|
|
|
|
---
|
|
|
|
## consultant
|
|
|
|
Display:
|
|
|
|
```txt
|
|
ที่ปรึกษา
|
|
```
|
|
|
|
---
|
|
|
|
# Scope UX.1.4 Dashboard KPI Terms
|
|
|
|
## Lead Count
|
|
|
|
Display:
|
|
|
|
```txt
|
|
จำนวนลีด
|
|
```
|
|
|
|
---
|
|
|
|
## Enquiry Count
|
|
|
|
Display:
|
|
|
|
```txt
|
|
จำนวนโอกาสขาย
|
|
```
|
|
|
|
---
|
|
|
|
## Won Count
|
|
|
|
Display:
|
|
|
|
```txt
|
|
จำนวนงานที่ชนะ
|
|
```
|
|
|
|
---
|
|
|
|
## Lost Count
|
|
|
|
Display:
|
|
|
|
```txt
|
|
จำนวนงานที่แพ้
|
|
```
|
|
|
|
---
|
|
|
|
## Revenue
|
|
|
|
Display:
|
|
|
|
```txt
|
|
มูลค่าใบเสนอราคา
|
|
```
|
|
|
|
---
|
|
|
|
## Conversion Rate
|
|
|
|
Display:
|
|
|
|
```txt
|
|
อัตราการเปลี่ยนสถานะ
|
|
```
|
|
|
|
---
|
|
|
|
# Scope UX.1.5 Status Labels
|
|
|
|
## Lead
|
|
|
|
```txt
|
|
ใหม่
|
|
ติดต่อแล้ว
|
|
ผ่านการคัดกรอง
|
|
ไม่ผ่านการคัดกรอง
|
|
ส่งต่อฝ่ายขายแล้ว
|
|
```
|
|
|
|
---
|
|
|
|
## Enquiry
|
|
|
|
```txt
|
|
โอกาสขาย
|
|
ชนะ
|
|
แพ้
|
|
```
|
|
|
|
Mapped from:
|
|
|
|
```txt
|
|
lead
|
|
enquiry
|
|
closed_won
|
|
closed_lost
|
|
```
|
|
|
|
---
|
|
|
|
# Scope UX.1.6 Menu Labels
|
|
|
|
CRM Menu:
|
|
|
|
```txt
|
|
Dashboard
|
|
ลีด
|
|
โอกาสขาย
|
|
ใบเสนอราคา
|
|
อนุมัติเอกสาร
|
|
ตั้งค่า CRM
|
|
```
|
|
|
|
---
|
|
|
|
# Scope UX.1.7 Form Labels
|
|
|
|
Update labels only.
|
|
|
|
Do NOT rename:
|
|
|
|
```txt
|
|
database fields
|
|
api fields
|
|
typescript types
|
|
server service names
|
|
table names
|
|
```
|
|
|
|
Business label only.
|
|
|
|
---
|
|
|
|
# Scope UX.1.8 PDF Terminology
|
|
|
|
Update document preview and PDF rendering labels.
|
|
|
|
Examples:
|
|
|
|
```txt
|
|
Billing Customer
|
|
→ ลูกค้าผู้รับใบเสนอราคา
|
|
|
|
Project Parties
|
|
→ ผู้เกี่ยวข้องในโครงการ
|
|
|
|
Quotation
|
|
→ ใบเสนอราคา
|
|
```
|
|
|
|
Do not modify template mapping keys.
|
|
|
|
---
|
|
|
|
# Scope UX.1.9 Reports
|
|
|
|
Report headers must use:
|
|
|
|
```txt
|
|
Thai business terms
|
|
```
|
|
|
|
while keeping export column codes unchanged internally.
|
|
|
|
---
|
|
|
|
# Explicit Non-Scope
|
|
|
|
Do NOT:
|
|
|
|
```txt
|
|
Rename database schema
|
|
Rename API routes
|
|
Rename TS types
|
|
Rename service folders
|
|
Create i18n system
|
|
Translate admin technical screens
|
|
```
|
|
|
|
---
|
|
|
|
# Output
|
|
|
|
1. Files Added
|
|
2. Files Modified
|
|
3. Terminology Registry
|
|
4. Menu Changes
|
|
5. Dashboard Changes
|
|
6. Form Changes
|
|
7. PDF Changes
|
|
8. Report Changes
|
|
9. Remaining Risks
|
|
|
|
---
|
|
|
|
# Definition of Done
|
|
|
|
✔ CRM terminology registry exists
|
|
|
|
✔ Menu terminology standardized
|
|
|
|
✔ Lead terminology standardized
|
|
|
|
✔ Enquiry terminology standardized
|
|
|
|
✔ Project Party terminology standardized
|
|
|
|
✔ Dashboard terminology standardized
|
|
|
|
✔ PDF terminology standardized
|
|
|
|
✔ Report terminology standardized
|
|
|
|
✔ No database changes
|
|
|
|
✔ No API changes
|
|
|
|
✔ No schema rename
|