API reference: /api/plan

{ "serverKeyConfigured": true, "model": "gpt-6.1-sol" }

curl -s https://devstack.bid/api/plan

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "prompt": { "type": "string", "minLength": 3, "description": "คำอธิบายแอป (ถูก clean และตัดที่ 2000 ตัวอักษร)" },
    "lang":   { "enum": ["en", "th"], "default": "en", "description": "ภาษาของ summary/คำอธิบาย/ข้อความ error" },
    "mode":   { "enum": ["auto", "fallback"], "default": "auto", "description": "fallback = ใช้ rule-based planner เสมอ" }
  },
  "required": ["prompt"]
}

{
  "type": "object",
  "required": ["source", "lang", "templateId", "projectName", "summary", "addons", "jsPm", "pyPm", "extraSteps", "fileTree", "starterFiles", "nextSteps", "warnings"],
  "properties": {
    "source":        { "enum": ["openai", "fallback"] },
    "model":         { "type": "string", "description": "เฉพาะ source=openai" },
    "fallbackReason":{ "type": "string", "description": "เฉพาะ source=fallback เช่น 'no OpenAI API key configured', 'offline mode requested', 'OpenAI 401: ...' (redact แล้ว)" },
    "lang":          { "enum": ["en", "th"] },
    "templateId":    { "enum": ["nextjs-dashboard", "vite-react-game", "express-api", "fastapi-ai", "streamlit-dashboard", "node-cli-npx", "pypi-package", "collab-workspace", "react-admin-tool", "nextjs-ai-chat"] },
    "projectName":   { "type": "string", "pattern": "^[a-z0-9._-]{1,50}$" },
    "summary":       { "type": "string" },
    "addons":        { "type": "array", "items": { "enum": ["typescript", "tailwind", "eslint", "testing", "docker", "ci"] } },
    "jsPm":          { "enum": ["npm", "pnpm", "yarn"] },
    "pyPm":          { "enum": ["pip", "uv"] },
    "extraSteps":    { "type": "array", "maxItems": 6, "items": { "$ref": "#/$defs/ResolvedStep" } },
    "fileTree":      { "type": "array", "items": { "type": "string" }, "maxItems": 40 },
    "starterFiles":  { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "content": { "type": "string" } } } },
    "nextSteps":     { "type": "array", "items": { "type": "string" } },
    "warnings":      { "type": "array", "items": { "type": "string" } }
  }
}

BASE=http://localhost:8787   # หรือ https://devstack.bid

# offline planner (ไม่เสียเงิน)
curl -s -X POST $BASE/api/plan -H 'content-type: application/json' \
  -d '{"prompt":"FastAPI service with pytest and Docker, use uv","lang":"en","mode":"fallback"}'

# AI ด้วย key ของเซิร์ฟเวอร์ (ภาษาไทย)
curl -s -X POST $BASE/api/plan -H 'content-type: application/json' \
  -d '{"prompt":"แดชบอร์ดยอดขายด้วย Next.js พร้อมเทสต์และ CI","lang":"th"}'

# AI ด้วย key ของผู้ใช้
curl -s -X POST $BASE/api/plan -H 'content-type: application/json' \
  -H "x-openai-key: $MY_OPENAI_KEY" -d '{"prompt":"realtime collaborative notes app"}'

# 415
curl -s -o /dev/null -w '%{http_code}\n' -X POST $BASE/api/plan -H 'content-type: text/plain' -d 'hi'
# 413 (17 KB)
head -c 17000 /dev/zero | tr '\0' 'a' | sed 's/^/{"prompt":"/;s/$/"}/' | \
  curl -s -o /dev/null -w '%{http_code}\n' -X POST $BASE/api/plan -H 'content-type: application/json' --data-binary @-

{
  "source": "fallback",
  "fallbackReason": "offline mode requested",
  "lang": "en",
  "templateId": "fastapi-ai",
  "projectName": "nvx-ai-api",
  "summary": "The rule-based (offline) planner picked “FastAPI + Python AI App”: ...",
  "addons": ["testing", "docker"],
  "jsPm": "npm",
  "pyPm": "uv",
  "extraSteps": [],
  "fileTree": ["nvx-ai-api/", "  .venv/", "  main.py", "..."],
  "starterFiles": [{ "path": "main.py", "content": "..." }, { "path": ".env.example", "content": "..." }, { "path": ".gitignore", "content": "..." }, { "path": "tests/test_sanity.py", "content": "..." }],
  "nextSteps": ["Stream responses with StreamingResponse for a chat UI.", "..."],
  "warnings": []
}