chore: initial commit of ai site platform

Co-authored-by: Cursor <cursoragent@cursor.com>

blueprint/ai/prompt-contract.md

@@ -0,0 +1,71 @@
+# AI 服务输入输出约定
+
+## 输入
+
+`POST /api/v1/apps:generate`（可由网关转到 FastAPI）
+
+| 字段 | 必填 | 说明 |
+|------|------|------|
+| prompt | 是 | 用户自然语言需求 |
+| excel | 否 | xlsx/xls/csv |
+| images[] | 否 | 页面截图/手绘线框，最多 10 |
+| storage_mode | 否 | 默认 `schema_per_app` |
+
+Excel 解析侧建议先产出中间结构再喂给 LLM：
+
+```json
+{
+  "sheets": [
+    {
+      "name": "Sheet1",
+      "headers": ["SKU", "商品名称", "仓库", "数量", "单价", "状态", "更新时间"],
+      "sample_rows": [
+        ["A-1001", "无线鼠标", "华东仓", 120, 59.9, "在售", "2026-07-01 10:00:00"]
+      ],
+      "inferred_types": {
+        "SKU": "string",
+        "数量": "int",
+        "单价": "decimal"
+      }
+    }
+  ]
+}
+```
+
+## 输出
+
+```json
+{
+  "draft": { "...": "AppBlueprint" },
+  "warnings": [
+    "列「备注」样本过少，已标为可空 text",
+    "截图中有图表区域，已生成 dashboard 草案"
+  ],
+  "confidence": 0.86,
+  "require_confirm": true
+}
+```
+
+规则：
+
+- `draft` 必须能通过 `app-blueprint.schema.json`
+- `confidence < 0.75` ⇒ `require_confirm=true`（前端禁止一键跳过）
+- 字段名、表名由 AI 生成后，**发布前中台会再次规范化/重写**
+- 不得在输出中包含数据库连接串、密码、任意 SQL
+
+## 系统提示词要点（实现时使用）
+
+1. 只输出符合 Schema 的 JSON（可包在 draft 字段）  
+2. 一表对应 Excel 主 sheet；多 sheet 才多 entity（≤ 20）  
+3. 优先 enum：当某列 distinct 值 ≤ 20 且稳定  
+4. 页面至少包含一个 `list`；若用户提到统计再加 `dashboard`  
+5. API operations 默认 `list/get/create/update/delete`；提到导入导出再加  
+6. `security.visibility` 默认 `private`，`row_policies` 默认 `tenant_isolated`  
+
+## 与中台的分工
+
+```text
+AI：理解意图，填蓝图
+中台：校验、改写标识符、建表、挂路由、强制租户隔离
+前端：确认页编辑蓝图 → publish → 用 blueprint 渲染
+```