Screen Examples

แต่ละหน้าจอต้องใช้ command อะไรบ้าง — สำหรับ UI designer และ developer ที่เริ่มต้นสร้าง UI บน DNA OS

RelationshipDocumentsFinanceAI WorkflowOperationsCatalog

Partner List

/รายชื่อคู่ค้าRelationship

ตารางคู่ค้าทั้งหมดพร้อมสรุปยอดเงิน — ใช้แทนมุมมองที่เน้นเอกสาร

Commands Required
partner.list
ดึงคู่ค้าทั้งหมดพร้อม summary ยอดเงิน
PartnerSummary[] — id, name, total_invoiced, total_received, outstanding, last_activity
เรียงตาม last_activity จากปัจจุบันย้อนหลัง
Data Shape
PartnerSummary {
  id: string
  name: string
  partner_type_label: string | null
  phone: string | null
  total_invoiced: number
  total_received: number
  outstanding: number
  last_activity: string | null
  document_count: number
}

Partner Timeline

/Business Timeline ของคู่ค้าRelationship

ประวัติ Event และเอกสารทั้งหมดของคู่ค้าคนหนึ่ง เรียงตามวันที่

Commands Required
partner.timeline
ดึง timeline + summary ของคู่ค้า
args: { "partner_id": "uuid" }
{ summary: PartnerSummary, timeline: PartnerTimelineEntry[] }
Partner Timeline เป็น Event-Centric — เอกสารเป็น artifact ของ event ไม่ใช่ตัว event เอง
Data Shape
PartnerTimelineEntry {
  date: string
  kind: "document" | "business_event"
  event_type: string
  title: string
  subtitle: string | null
  amount: number | null
  status: string | null
  document_id?: string
  document_number?: string
  business_event_id?: string
}

Invoice List

/รายการใบแจ้งหนี้Documents

ตารางใบแจ้งหนี้ทั้งหมด — ใช้ partner.timeline แทนถ้าต้องการดูในบริบทของคู่ค้า

Commands Required
invoice.list
ดึงเอกสารทุกชิ้นที่เป็น invoice
Document[] — document_type=invoice
invoice.latest
ดึงใบแจ้งหนี้ล่าสุดเพื่อแสดงตัวเลขเร็ว
Document | null
Data Shape
Document {
  id: string
  document_type: string
  document_number: string
  status: string
  partner_id: string
  net_amount: number
  issue_date: string
  business_event_id: string | null
}

Debt Dashboard

/แดชบอร์ดหนี้Finance

สรุปหนี้ค้างชำระและรายการติดตาม

Commands Required
debt.list
หนี้ที่ยังค้างชำระ (OPEN)
InvoiceDebt[]
debt.trackings
รายการติดตามลูกหนี้ (debt_trackings table)
DebtTracking[]
debt.all
หนี้ทุกสถานะ (ใช้เมื่อต้องการดูประวัติ)
InvoiceDebt[]
Data Shape
InvoiceDebt {
  id: string
  document_id: string
  invoice_status: "OPEN" | "PARTIAL" | "PAID" | "OVERDUE"
  outstanding_amount: number
  paid_amount: number
}

Document Flow

/ประวัติเอกสารทั้งหมดDocuments

เอกสารทุกประเภทในระบบ — ใช้เป็น audit trail

Commands Required
document.list
เอกสารทุกชิ้นทุกประเภท
Document[]
document.boq
เฉพาะ BOQ
Document[]
document.po
เฉพาะ Purchase Order
Document[]
document.do
เฉพาะ Delivery Order
Document[]
document.receipt
เฉพาะใบเสร็จ
Document[]
Data Shape
Document {
  id, document_type, document_number,
  status, partner_id, net_amount, issue_date
}

Draft Approval

/อนุมัติร่างจาก LINEAI Workflow

หน้าตรวจสอบและอนุมัติร่างเอกสารที่ AI วิเคราะห์จาก LINE

Commands Required
draft.list
ร่างเอกสารที่รอการอนุมัติ
LineDraftDocument[]
การอนุมัติ (approve) ต้องทำผ่าน /admin UI เท่านั้น — Rule 72 บล็อก external AI
Data Shape
LineDraftDocument {
  id: string
  doc_type: string
  status: "pending" | "approved" | "rejected"
  payload: Record<string, unknown>
  created_at: string
}

Job Board

/กระดานงานOperations

ติดตามงานจัดส่งและโปรเจกต์

Commands Required
job.active
งานที่กำลังดำเนินการ (IN_PROGRESS)
Job[]
job.list
งานทั้งหมดทุกสถานะ
Job[]
Data Shape
Job {
  id: string
  partner_id: string
  job_status: "PENDING" | "IN_PROGRESS" | "DONE" | "CANCELLED"
  distance_km: number | null
  required_quantity: number | null
}

Material Catalog

/รายการวัสดุCatalog

รายการวัสดุ/สินค้าในระบบ — ใช้ใน dropdown ตอนสร้างเอกสาร

Commands Required
material.list
วัสดุทุกประเภท
MaterialType[]
Data Shape
MaterialType {
  id: string
  name: string
}
ทดลองเรียก command จริง → API Playground
ดู spec ครบทุก command → /api/v1/spec