feat: add real PDF ingestion workflow

contracts/workflow-contract.md

@@ -39,3 +39,11 @@
 - `GET /v1/readiness`：供前端决定是否解锁设计工作流。
 
 任何密钥字段都不会出现在 `values` 中，只会在 `configured` 中返回布尔值。必备配置未完成或测试未通过时，上传与命令接口返回 `503` 和 `SETTINGS_INCOMPLETE`。
+
+## Project Ingestion
+
+- `GET /v1/projects`：按更新时间返回持久化项目。
+- `POST /v1/projects/ingest`：以 `multipart/form-data` 上传 `file`，可选 `project_name`；当前接受 25 MB 以内 PDF。
+- `GET /v1/projects/{project_id}/preview`：从 MinIO 派生文件桶读取 PDF 首页预览。
+- 新项目初始阶段为 `region_selection`，`plan.regions` 提供归一化的 `[x0, y0, x1, y1]` 候选区域。
+- `select_region` 必须引用真实存在的候选区域 ID，成功后修订号递增并进入 `plan_review`。