การไหลของข้อมูล · Data flow

sequenceDiagram
  participant U as ผู้ใช้
  participant B as Builder (builder.tsx)
  participant C as composer.ts
  participant P as placeholders.ts
  participant S as scripts.ts / download.ts
  U->>B: เลือกเทมเพลต + ตัวเลือก (Configure)
  B->>C: composeSteps(config)
  C->>C: normalizeConfig
  C->>P: buildContext(config, template)
  C->>C: runtime + template(when) + add-ons + resolveStep + dedupe
  C-->>B: ResolvedStep[] (composed)
  U->>B: ลาก/ลบ/เพิ่ม (Review)
  B->>C: applyEdits(composed, edits)
  C-->>B: ลำดับสุดท้าย
  B->>B: encodeShare -> URL #s= + localStorage
  U->>B: Export
  B->>S: toBash / toPowerShell / toReadme / buildStarterZip
  S-->>U: ไฟล์ดาวน์โหลด (Blob ในเบราว์เซอร์)

sequenceDiagram
  participant A as AgentPanel
  participant R as POST /api/plan
  participant L as checkRateLimit
  participant O as OpenAI Responses API
  participant F as planFallback
  participant V as sanitizeAiPlan
  A->>R: { prompt, lang, mode } (+ x-openai-key)
  R->>L: NVX_PLAN_LIMITER (ทุก POST)
  alt เกิน
    R-->>A: 429 + Retry-After: 60
  end
  R->>R: readJsonBody (≤16KB, JSON) + cleanText(prompt, 2000)
  alt mode = fallback หรือไม่มี key
    R->>F: planFallback(prompt, lang, reason)
    F-->>A: AgentPlan (source: fallback)
  else มี key
    opt ใช้ key ของเซิร์ฟเวอร์
      R->>L: NVX_PLAN_AI_LIMITER
    end
    R->>O: Structured Outputs (strict JSON Schema, store: false)
    alt สำเร็จ
      O-->>R: JSON
      R->>V: zod + sanitizeStep + dedupe กับคำสั่งเทมเพลต
      V-->>A: AgentPlan (source: openai, warnings)
    else error / timeout / invalid
      R->>F: planFallback(reason ที่ redact แล้ว)
      F-->>A: AgentPlan (source: fallback)
    end
  end
  A->>A: Load into builder -> config + edits.custom (+ custom-ai-files)