Developer Docs

Developer Docs

หน้านี้เป็น entry point สำหรับทีมพัฒนาในการทำงานกับระบบ kobi-ai รุ่นปัจจุบัน โดยโฟกัส execution path จริงจาก route จนถึง BFF/API และ workspace runtime

Engineering Baseline

• Runtime หลักใช้ UnifiedChatView + ChatPane + DynamicCanvasLoader
• Mode registration ขับเคลื่อนด้วย manifest และ canvas registry
• API ชั้น BFF เป็น trust boundary ก่อนเรียก engine/service ภายนอก
• Scope-first architecture เป็นแกนของการ validate และ canonicalize URL/state
• HITL flow (approve/reject/resume) เป็น first-class path สำหรับ idea/strategy/maps/analytics

เอกสารหลักที่ควรอ่านตามลำดับ

1. Developer Overview
2. Architecture Home
3. System Topology and Layers
4. Scope Model and Data Ownership
5. Thread and State Lifecycle
6. Runtime Flow Diagrams
7. API and Event Contracts
8. Operations Runbook

Quick Model

flowchart TB
  U[Routes / Chat Entry] --> V[UnifiedChatView]
  V --> C[ChatPane]
  V --> D[DynamicCanvasLoader]
  C --> S[Services]
  D --> S
  S --> A["/api/ai/(all)"]
  S --> H["/api/chat/(all)"]
  S --> W["/api/canvas|maps|dashboard/(all)"]