Architecture Status (2026-03-04)

Architecture Status (2026-03-04)

หน้านี้สรุปสถานะ runtime ปัจจุบันจากการวิเคราะห์โค้ดจริงใน kobi-ai เพื่อใช้เป็น baseline กลางของทีม

Baseline ที่ยืนยันแล้ว

• ระบบใช้โครง Unified Chat + Dynamic Workspace ชัดเจน
• Orchestration กลางอยู่ที่ UnifiedChatView และ ChatPane
• โหมดหลัก 5 โหมด (general, maps, idea, strategy, analytics) ใช้สัญญาแชตร่วมกัน
• API ฝั่ง /api/ai/*, /api/chat/*, /api/canvas/*, /api/maps/*, /api/dashboard/* เป็น trust boundary
• Scope-first model (project/thread/board/map/dashboard/share) ถูกบังคับซ้ำทั้งฝั่ง UI และ BFF

Runtime Health Map

flowchart LR
  subgraph Stable[แข็งแรง / เสถียร]
    S1[Manifest + Registry Architecture]
    S2[Scope Validation in BFF]
    S3[HITL Resume Flow]
    S4[Maps Realtime Token Assertions]
  end

  subgraph Watch[ต้องเฝ้าระวัง]
    W1[Compatibility Fallback Branches]
    W2[Cross-Mode Scope Canonicalization]
    W3[Analytics Workspace Size]
  end

  subgraph Hotspots[Complexity สูง]
    H1[ChatPane]
    H2[useChatActions]
    H3["api/ai/_proxy.js"]
    H4["api/canvas/_service.js"]
  end

  S1 --> W2
  S2 --> W1
  S3 --> H2
  S4 --> W2
  W1 --> H3
  W2 --> H1
  W3 --> H4

จุดแข็งเชิงวิศวกรรม

1. แยก orchestration, workspace domain และ API boundary ได้ดี
2. mode/canvas/tool ออกแบบแบบ manifest-driven ลด hardcode
3. flow HITL รองรับ batch decision + resume stream ได้ค่อนข้างครบ
4. มี compatibility guards รองรับช่วง migration schema

ความเสี่ยงหลัก

1. ความซับซ้อนรวมสูงในคอมโพเนนต์ orchestration และ API hub
2. fallback path จำนวนมากทำให้ behavior matrix โตเร็ว
3. semantics ของ boardId/mapId/dashboardId ยังต้องคุมเข้มตลอดการเพิ่ม feature
4. analytics workspace ขนาดใหญ่และมี hooks หลายชุด เสี่ยงต่อ regression ถ้าไม่แบ่ง boundary ต่อเนื่อง

Priority Roadmap

1. สร้าง Scope Contract Matrix กลางสำหรับ FE/BFF
2. แยก ChatPane เป็น presentation shell + orchestration hooks
3. เพิ่ม integration tests สำหรับ critical paths ข้ามโหมด
4. วาง milestone ปิด legacy fallback แบบ staged
5. เพิ่ม telemetry สำหรับ mismatch และ fallback hit rate