feat(frontend): v3.0 — project-first 3-step wizard

- Rewrite landing to health-badge + 4 entry tiles
- /projects list (GET /projects), /projects/new form (POST /projects)
- /projects/{id} 3-step wizard:
- Step A BlueprintsPanel — multi-upload to project (POST /uploads/blueprint)
- Step B DocumentationPanel — GET /dokumentatsiya + POST /extract-all with
Cached badge when aggregate_sha256 matches last_summary, Run button otherwise
- Step C SheetVisionPanel — POST /extract-sheets w/ (upload_id, page_no) pairs
- /documents — template picker + .docx render & download (POST /documents/render)
- /history — GET /inference/history with project_id chip filter
- lib/api.ts: add v2.0 types & 6 new functions
(listProjectUploads, projectDokumentatsiya, extractProjectAll,
extractProjectSheetsV2, uploadBlueprintV2) + UploadRow/DokumentatsiyaResponse
- Drop legacy /blueprint single-upload flow

frontend/app/blueprint/page.tsx

@@ -1,396 +0,0 @@
-"use client";
-
-/** Two-step project-documentation flow (D-light, no OCR).
- *
- *  Step 1 — upload PDF → server extracts native text on all pages →
- *           render the page list (stamp + title). User can run
- *           "Сводка по тексту" to get an LLM project summary.
- *
- *  Step 2 — user picks specific pages → server runs VLM *only* on
- *           those pages with sibling text as context.
- */
-
-import { useMemo, useState } from "react";
-import {
-  extractProjectSheets,
-  extractProjectText,
-  getPagePreview,
-  uploadBlueprint,
-  type PageExcerpt,
-  type ProjectSummary,
-  type ProjectSummaryResponse,
-  type UploadBlueprintStatus,
-} from "@/lib/api";
-
-type Phase = "idle" | "uploading" | "ingested" | "text_summary" | "vision" | "error";
-
-function summariseShort(p: PageExcerpt): string {
-  if (p.stamp) return p.stamp;
-  if (p.title_guess) return p.title_guess;
-  if (p.text_preview) return p.text_preview.slice(0, 60);
-  return `стр. ${p.page_no}`;
-}
-
-function Section({
-  title,
-  children,
-}: {
-  title: string;
-  children: React.ReactNode;
-}) {
-  return (
-    <section className="rounded-lg border border-slate-200 bg-white p-5 shadow-sm">
-      <h2 className="mb-3 text-lg font-semibold">{title}</h2>
-      {children}
-    </section>
-  );
-}
-
-function SummaryBlock({ s }: { s: ProjectSummary }) {
-  return (
-    <div className="space-y-3 text-sm">
-      <div>
-        <div className="text-slate-500 text-xs uppercase">Объект</div>
-        <div className="font-medium">{s.object_name}</div>
-        {s.object_address && (
-          <div className="text-slate-600">{s.object_address}</div>
-        )}
-        {s.project_section && (
-          <div className="text-slate-600">Раздел: {s.project_section}</div>
-        )}
-      </div>
-      <div className="grid grid-cols-3 gap-2 text-center">
-        <Stat label="Листов" value={s.totals.sheet_count} />
-        <Stat label="Со штампом" value={s.totals.sheets_with_stamp} />
-        <Stat label="Текст. стр." value={s.totals.text_pages} />
-      </div>
-      {s.spec_summary && (
-        <div>
-          <div className="text-slate-500 text-xs uppercase">Состав</div>
-          <p className="whitespace-pre-wrap text-slate-800">{s.spec_summary}</p>
-        </div>
-      )}
-      {s.sheets_index.length > 0 && (
-        <div>
-          <div className="text-slate-500 text-xs uppercase">Штамповый индекс</div>
-          <ul className="mt-1 grid grid-cols-2 gap-x-3 gap-y-1 md:grid-cols-3">
-            {s.sheets_index.map((x) => (
-              <li key={x.page_no} className="truncate">
-                <span className="text-slate-500">стр. {x.page_no}</span>{" "}
-                <span className="font-mono text-xs">
-                  {x.stamp?.split(" ")[0] ?? "—"}
-                </span>
-                {x.title_guess && (
-                  <span className="ml-1 text-slate-600 truncate">
-                    — {x.title_guess.slice(0, 50)}
-                  </span>
-                )}
-              </li>
-            ))}
-          </ul>
-        </div>
-      )}
-      {s.missing_info_prompts.length > 0 && (
-        <div>
-          <div className="text-slate-500 text-xs uppercase">
-            Что нужно уточнить
-          </div>
-          <ul className="list-disc pl-5 text-slate-800">
-            {s.missing_info_prompts.map((p, i) => (
-              <li key={i}>{p}</li>
-            ))}
-          </ul>
-        </div>
-      )}
-    </div>
-  );
-}
-
-function Stat({ label, value }: { label: string; value: number }) {
-  return (
-    <div className="rounded border border-slate-200 bg-slate-50 p-2">
-      <div className="text-2xl font-semibold tabular-nums">{value}</div>
-      <div className="text-[11px] uppercase text-slate-500">{label}</div>
-    </div>
-  );
-}
-
-export default function BlueprintPage() {
-  const [phase, setPhase] = useState<Phase>("idle");
-  const [error, setError] = useState<string | null>(null);
-  const [status, setStatus] = useState<UploadBlueprintStatus | null>(null);
-  const [textSummary, setTextSummary] =
-    useState<ProjectSummaryResponse | null>(null);
-  const [visionSummary, setVisionSummary] =
-    useState<ProjectSummaryResponse | null>(null);
-  const [selected, setSelected] = useState<Set<number>>(new Set());
-  const [previewUrl, setPreviewUrl] = useState<{ page_no: number; url: string } | null>(
-    null,
-  );
-
-  async function onFile(file: File | undefined) {
-    if (!file) return;
-    setError(null);
-    setStatus(null);
-    setTextSummary(null);
-    setVisionSummary(null);
-    setSelected(new Set());
-    setPhase("uploading");
-    try {
-      const s = await uploadBlueprint(file);
-      setStatus(s);
-      setPhase("ingested");
-    } catch (e) {
-      setError(e instanceof Error ? e.message : String(e));
-      setPhase("error");
-    }
-  }
-
-  async function runTextSummary() {
-    if (!status?.upload_id) return;
-    setError(null);
-    setPhase("text_summary");
-    try {
-      const r = await extractProjectText(status.upload_id);
-      setTextSummary(r);
-      setPhase("ingested");
-    } catch (e) {
-      setError(e instanceof Error ? e.message : String(e));
-      setPhase("error");
-    }
-  }
-
-  async function runVisionSummary() {
-    if (!status?.upload_id || selected.size === 0) return;
-    // v1.0.1 — defensive filtering on the wire payload.
-    // Backend rejects anything < 1; we already use Set<number>, but a
-    // double-click / future state-mutation could push a 0 or negative.
-    const requested = Array.from(selected)
-      .filter((n): n is number => Number.isInteger(n) && n > 0)
-      .filter((n, idx, arr) => arr.indexOf(n) === idx) // de-dup just in case
-      .sort((a, b) => a - b);
-    if (requested.length === 0) {
-      setError("Не выбрано ни одной валидной страницы");
-      return;
-    }
-    if (typeof window !== "undefined" && window.console) {
-      // eslint-disable-next-line no-console
-      console.log("[blueprint] vision payload pages=", requested, "upload_id=", status.upload_id);
-    }
-    if (requested.length !== selected.size) {
-      // eslint-disable-next-line no-console
-      console.warn(
-        `[blueprint] dropped ${selected.size - requested.length} invalid page(s) — sent ${requested.length}`,
-      );
-    }
-    setError(null);
-    setPhase("vision");
-    try {
-      const r = await extractProjectSheets(status.upload_id, requested);
-      setVisionSummary(r);
-      setPhase("ingested");
-    } catch (e) {
-      setError(e instanceof Error ? e.message : String(e));
-      setPhase("error");
-    }
-  }
-
-  async function showPreview(page_no: number) {
-    if (!status?.upload_id) return;
-    setError(null);
-    try {
-      const p = await getPagePreview(status.upload_id, page_no);
-      const url = `data:${p.mime};base64,${p.data_b64}`;
-      setPreviewUrl({ page_no, url });
-    } catch (e) {
-      setError(e instanceof Error ? e.message : String(e));
-    }
-  }
-
-  const pageRows = useMemo(() => status?.pages ?? [], [status?.pages]);
-
-  const toggleSelected = (no: number) =>
-    setSelected((prev) => {
-      const next = new Set(prev);
-      if (next.has(no)) next.delete(no);
-      else next.add(no);
-      return next;
-    });
-
-  return (
-    <main className="mx-auto max-w-5xl space-y-6 px-6 py-10">
-      <header>
-        <h1 className="text-2xl font-semibold tracking-tight">
-          Проектная документация
-        </h1>
-        <p className="mt-1 text-slate-600">
-          Шаг 1 — загрузите PDF: текст всех страниц распознаётся автоматически.
-          Шаг 2 — выберите конкретные листы, чтобы получить распознавание
-          через VLM с учётом соседних страниц.
-        </p>
-      </header>
-
-      {error && (
-        <div className="rounded border border-red-300 bg-red-50 px-3 py-2 text-sm text-red-800">
-          {error}
-        </div>
-      )}
-
-      <Section title="Шаг 1 — загрузка">
-        <label className="flex w-full cursor-pointer items-center justify-center rounded-md border-2 border-dashed border-slate-300 bg-slate-50 px-4 py-10 text-slate-500 hover:bg-slate-100">
-          <input
-            type="file"
-            accept="application/pdf,image/png,image/jpeg,image/heic,image/heif,image/webp"
-            className="hidden"
-            onChange={(e) => onFile(e.target.files?.[0])}
-            disabled={phase === "uploading" || phase === "text_summary" || phase === "vision"}
-            data-testid="blueprint-file"
-          />
-          {phase === "uploading"
-            ? "Загружаем и распознаём…"
-            : "Кликните или перетащите PDF / изображение сюда"}
-        </label>
-
-        {status && (
-          <div className="mt-4 space-y-3 text-sm">
-            <div className="flex flex-wrap gap-3 text-slate-700">
-              <span>Файл: <b>{status.file_name}</b></span>
-              <span>·</span>
-              <span>Стр.: <b>{status.page_count}</b></span>
-              <span>·</span>
-              <span>
-                В Supabase:{" "}
-                <b className={status.stored_in_supabase ? "text-emerald-600" : "text-amber-600"}>
-                  {status.stored_in_supabase ? "да" : "нет"}
-                </b>
-              </span>
-              <span>·</span>
-              <span>
-                С текстом:{" "}
-                <b className={status.has_native_text ? "text-emerald-600" : "text-amber-600"}>
-                  {status.has_native_text ? "да" : "нет"}
-                </b>
-              </span>
-            </div>
-
-            <div className="flex flex-wrap gap-2">
-              <button
-                type="button"
-                onClick={runTextSummary}
-                disabled={!status.has_native_text}
-                className="rounded bg-slate-900 px-3 py-1.5 text-white shadow hover:bg-slate-800 disabled:opacity-50"
-              >
-                Сводка по тексту (все страницы)
-              </button>
-              {!status.has_native_text && (
-                <span className="self-center text-xs text-amber-700">
-                  Без native-текста (скан) — шаг 2 через VLM доступен.
-                </span>
-              )}
-            </div>
-          </div>
-        )}
-      </Section>
-
-      {textSummary && (
-        <Section title={`Текст-сводка · модель ${textSummary.model_used}`}>
-          <SummaryBlock s={textSummary.summary} />
-        </Section>
-      )}
-
-      {status && status.pages.length > 0 && (
-        <Section title="Шаг 2 — выберите листы для VLM-распознавания">
-          <p className="mb-3 text-xs text-slate-500">
-            Сервер прогонит vision-LLM только по выбранным страницам и
-            подаст соседние страницы как контекст.
-          </p>
-          <ul className="grid grid-cols-1 gap-2 md:grid-cols-2">
-            {pageRows.map((p) => (
-              <li
-                key={p.page_no}
-                className={`flex items-start gap-2 rounded border p-2 text-sm ${
-                  selected.has(p.page_no)
-                    ? "border-slate-900 bg-slate-50"
-                    : "border-slate-200"
-                }`}
-              >
-                <input
-                  type="checkbox"
-                  className="mt-1"
-                  checked={selected.has(p.page_no)}
-                  onChange={() => toggleSelected(p.page_no)}
-                />
-                <div className="min-w-0 flex-1">
-                  <div className="flex items-baseline gap-2">
-                    <span className="font-mono text-xs text-slate-500">
-                      стр. {p.page_no}
-                    </span>
-                    {p.stamp && (
-                      <span className="font-mono text-xs font-semibold">
-                        {p.stamp.split(" ")[0]}
-                      </span>
-                    )}
-                  </div>
-                  <div className="truncate text-slate-800">
-                    {p.title_guess || summariseShort(p)}
-                  </div>
-                  {p.text_preview && (
-                    <div className="line-clamp-2 text-[11px] text-slate-500">
-                      {p.text_preview}
-                    </div>
-                  )}
-                </div>
-                <button
-                  type="button"
-                  onClick={() => showPreview(p.page_no)}
-                  className="shrink-0 rounded border border-slate-300 px-2 py-0.5 text-xs hover:bg-slate-100"
-                >
-                  превью
-                </button>
-              </li>
-            ))}
-          </ul>
-
-          <div className="mt-4 flex items-center gap-3">
-            <button
-              type="button"
-              onClick={runVisionSummary}
-              disabled={selected.size === 0 || phase === "vision"}
-              className="rounded bg-slate-900 px-3 py-1.5 text-white shadow hover:bg-slate-800 disabled:opacity-50"
-            >
-              {phase === "vision"
-                ? "VLM обрабатывает…"
-                : `VLM по выбранным (${selected.size})`}
-            </button>
-            <button
-              type="button"
-              onClick={() => setSelected(new Set())}
-              className="text-xs text-slate-500 underline"
-            >
-              снять выделение
-            </button>
-          </div>
-        </Section>
-      )}
-
-      {visionSummary && (
-        <Section title={`VLM-сводка · модель ${visionSummary.model_used} · ${visionSummary.page_count} лист(а/ов)`}>
-          <SummaryBlock s={visionSummary.summary} />
-        </Section>
-      )}
-
-      {previewUrl && (
-        <div
-          className="fixed inset-0 z-40 flex items-center justify-center bg-black/60 p-4"
-          onClick={() => setPreviewUrl(null)}
-        >
-          <img
-            src={previewUrl.url}
-            alt={`стр. ${previewUrl.page_no}`}
-            className="max-h-full max-w-full rounded shadow-2xl"
-          />
-        </div>
-      )}
-    </main>
-  );
-}

frontend/app/documents/page.tsx

@@ -0,0 +1,237 @@
+"use client";
+
+/** /documents — list templates + render to .docx. */
+
+import Link from "next/link";
+import { useEffect, useMemo, useState } from "react";
+import { useSearchParams } from "next/navigation";
+import {
+  listDocumentTemplates,
+  listProjects,
+  renderDocument,
+  type Project,
+} from "@/lib/api";
+
+const TEMPLATE_LABELS: Record<string, string> = {
+  act_hidden_works: "Акт освидетельствования скрытых работ",
+  act_osmotr_responsibility: "Акт осмотра ответственных конструкций",
+  general_work_log: "Общий журнал работ",
+  material_certificate: "Сертификат на материал",
+};
+
+export default function DocumentsPage() {
+  const params = useSearchParams();
+  const presetProjectId = params?.get("project_id") || "";
+
+  const [templates, setTemplates] = useState<string[]>([]);
+  const [projects, setProjects] = useState<Project[]>([]);
+  const [template, setTemplate] = useState<string>("");
+  const [projectId, setProjectId] = useState<string>(presetProjectId);
+  const [contextRaw, setContextRaw] = useState<string>("{}");
+  const [loading, setLoading] = useState<{ templates: boolean; render: boolean }>({
+    templates: true,
+    render: false,
+  });
+  const [error, setError] = useState<string | null>(null);
+  const [lastDownload, setLastDownload] = useState<{
+    name: string;
+    size: number;
+    ts: string;
+  } | null>(null);
+
+  useEffect(() => {
+    listDocumentTemplates()
+      .then((r) => {
+        setTemplates(r.supported);
+        if (r.supported.length > 0) setTemplate(r.supported[0]);
+      })
+      .catch((e) =>
+        setError(e instanceof Error ? e.message : String(e)),
+      )
+      .finally(() =>
+        setLoading((s) => ({ ...s, templates: false })),
+      );
+
+    listProjects()
+      .then((rows) => {
+        setProjects(rows);
+        if (!projectId && rows.length > 0)
+          setProjectId(rows[0].id);
+      })
+      .catch(() => setProjects([]));
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  const projectLabel = useMemo(() => {
+    if (!projectId) return "не выбран";
+    const p = projects.find((x) => x.id === projectId);
+    return p ? p.object_name || "(без названия)" : projectId.slice(0, 8);
+  }, [projectId, projects]);
+
+  const handleRender = async () => {
+    setError(null);
+    if (!template) {
+      setError("Шаблон не выбран.");
+      return;
+    }
+    if (!projectId) {
+      setError("Проект обязателен для рендеринга.");
+      return;
+    }
+    let ctx: Record<string, unknown> = {};
+    try {
+      const parsed = JSON.parse(contextRaw || "{}");
+      if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+        ctx = parsed as Record<string, unknown>;
+      } else {
+        setError('Контекст должен быть JSON-объектом, например {"work":"..."}');
+        return;
+      }
+    } catch (e) {
+      setError(
+        `Невалидный JSON в поле "контекст": ${e instanceof Error ? e.message : String(e)}`,
+      );
+      return;
+    }
+
+    setLoading((s) => ({ ...s, render: true }));
+    try {
+      const blob = await renderDocument(template, projectId, ctx);
+      const filename = `${template}_${projectId.slice(0, 8)}.docx`;
+      const url = URL.createObjectURL(blob);
+      const a = document.createElement("a");
+      a.href = url;
+      a.download = filename;
+      a.click();
+      URL.revokeObjectURL(url);
+      setLastDownload({
+        name: filename,
+        size: blob.size,
+        ts: new Date().toLocaleString("ru-RU"),
+      });
+    } catch (e) {
+      setError(e instanceof Error ? e.message : String(e));
+    } finally {
+      setLoading((s) => ({ ...s, render: false }));
+    }
+  };
+
+  return (
+    <main className="mx-auto max-w-xl space-y-5 px-4 py-8">
+      <header>
+        <h1 className="text-2xl font-bold tracking-tight text-slate-900">
+          Документы и шаблоны
+        </h1>
+        <p className="mt-1 text-sm text-slate-600">
+          Выберите проект и шаблон → сгенерируйте .docx и скачайте.
+        </p>
+      </header>
+
+      <section className="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm">
+        {loading.templates ? (
+          <p className="text-sm text-slate-500">Загружаем шаблоны...</p>
+        ) : templates.length === 0 ? (
+          <p className="text-sm text-rose-700">
+            Сервер не вернул список шаблонов.
+          </p>
+        ) : (
+          <div className="space-y-4">
+            <label className="block">
+              <span className="mb-1 block text-sm font-medium text-slate-700">
+                Шаблон
+              </span>
+              <select
+                value={template}
+                onChange={(e) => setTemplate(e.target.value)}
+                className="w-full rounded-xl border border-slate-300 bg-white px-3 py-2 text-base outline-none focus:border-slate-900 focus:ring-2 focus:ring-slate-900/20"
+              >
+                {templates.map((t) => (
+                  <option key={t} value={t}>
+                    {TEMPLATE_LABELS[t] || t} ({t})
+                  </option>
+                ))}
+              </select>
+            </label>
+
+            <label className="block">
+              <span className="mb-1 block text-sm font-medium text-slate-700">
+                Проект
+              </span>
+              <select
+                value={projectId}
+                onChange={(e) => setProjectId(e.target.value)}
+                className="w-full rounded-xl border border-slate-300 bg-white px-3 py-2 text-base outline-none focus:border-slate-900 focus:ring-2 focus:ring-slate-900/20"
+              >
+                <option value="">— не выбран —</option>
+                {projects.map((p) => (
+                  <option key={p.id} value={p.id}>
+                    {p.object_name || "(без названия)"} · {p.contract_no || "—"}
+                  </option>
+                ))}
+              </select>
+              <span className="mt-1 block text-[11px] text-slate-500">
+                выбрано: <span className="font-mono">{projectLabel}</span>
+              </span>
+            </label>
+
+            <label className="block">
+              <span className="mb-1 block text-sm font-medium text-slate-700">
+                Контекст (JSON, опционально)
+              </span>
+              <textarea
+                value={contextRaw}
+                onChange={(e) => setContextRaw(e.target.value)}
+                rows={6}
+                spellCheck={false}
+                className="w-full rounded-xl border border-slate-300 bg-white px-3 py-2 font-mono text-xs outline-none focus:border-slate-900 focus:ring-2 focus:ring-slate-900/20"
+                placeholder='{"work_name":"Армирование","date":"2026-06-28"}'
+              />
+              <span className="mt-1 block text-[11px] text-slate-500">
+                Шаблон подставляет значения из этого объекта в .docx.
+              </span>
+            </label>
+          </div>
+        )}
+      </section>
+
+      <button
+        type="button"
+        onClick={handleRender}
+        disabled={
+          loading.render || loading.templates || !template || !projectId
+        }
+        className="w-full rounded-2xl bg-slate-900 py-3 font-semibold text-white shadow hover:bg-slate-800 disabled:opacity-50"
+      >
+        {loading.render ? "Рендерим..." : "Сгенерировать и скачать .docx"}
+      </button>
+
+      {error && (
+        <div className="rounded-2xl border border-rose-200 bg-rose-50 p-4 text-sm text-rose-700">
+          {error}
+        </div>
+      )}
+
+      {lastDownload && (
+        <section className="rounded-2xl border border-emerald-200 bg-emerald-50 p-4 text-xs text-emerald-800">
+          Готово: <code className="font-mono">{lastDownload.name}</code> ·{" "}
+          {Math.round(lastDownload.size / 1024)} KB · {lastDownload.ts}
+        </section>
+      )}
+
+      <footer className="flex justify-between pt-4">
+        <Link
+          href="/projects"
+          className="text-xs text-slate-400 hover:text-slate-600"
+        >
+          ← все проекты
+        </Link>
+        <Link
+          href="/"
+          className="text-xs text-slate-400 hover:text-slate-600"
+        >
+          на главную →
+        </Link>
+      </footer>
+    </main>
+  );
+}

frontend/app/history/page.tsx

@@ -0,0 +1,163 @@
+"use client";
+
+/** /history — read /inference/history. Optional project_id filter. */
+
+import Link from "next/link";
+import { useEffect, useMemo, useState } from "react";
+import { useSearchParams } from "next/navigation";
+import {
+  listInferenceHistory,
+  listProjects,
+  type InferenceHistoryRow,
+  type Project,
+} from "@/lib/api";
+
+export default function HistoryPage() {
+  const params = useSearchParams();
+  const projectId = params?.get("project_id") || "";
+  const [projects, setProjects] = useState<Project[]>([]);
+  const [rows, setRows] = useState<InferenceHistoryRow[] | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    listProjects().then(setProjects).catch(() => setProjects([]));
+  }, []);
+
+  useEffect(() => {
+    setRows(null);
+    setError(null);
+    listInferenceHistory(projectId || undefined)
+      .then(setRows)
+      .catch((e) =>
+        setError(e instanceof Error ? e.message : String(e)),
+      );
+  }, [projectId]);
+
+  const projectLabel = useMemo(() => {
+    if (!projectId) return "все проекты";
+    const p = projects.find((x) => x.id === projectId);
+    return p
+      ? `${p.object_name || "(без названия)"} (${p.id.slice(0, 8)})`
+      : `id: ${projectId.slice(0, 8)}`;
+  }, [projectId, projects]);
+
+  return (
+    <main className="mx-auto max-w-3xl px-4 py-8">
+      <header className="mb-6">
+        <h1 className="text-2xl font-bold tracking-tight text-slate-900">
+          История инференсов
+        </h1>
+        <p className="mt-1 text-sm text-slate-600">
+          Проект: <span className="font-mono">{projectLabel}</span>
+        </p>
+      </header>
+
+      <div className="mb-6 flex flex-wrap items-center gap-2">
+        <Link
+          href="/history"
+          className={
+            "rounded-full px-3 py-1 text-xs font-medium " +
+            (!projectId
+              ? "bg-slate-900 text-white"
+              : "bg-slate-100 text-slate-700 hover:bg-slate-200")
+          }
+        >
+          Все
+        </Link>
+        {projects.map((p) => (
+          <Link
+            key={p.id}
+            href={`/history?project_id=${p.id}`}
+            className={
+              "rounded-full px-3 py-1 text-xs font-medium " +
+              (projectId === p.id
+                ? "bg-slate-900 text-white"
+                : "bg-slate-100 text-slate-700 hover:bg-slate-200")
+            }
+          >
+            {p.object_name || "(без названия)"}
+          </Link>
+        ))}
+      </div>
+
+      {error && (
+        <div className="rounded-2xl border border-rose-200 bg-rose-50 p-4 text-sm text-rose-700">
+          {error}
+        </div>
+      )}
+
+      {rows === null && !error && (
+        <p className="text-sm text-slate-500">Загружаем...</p>
+      )}
+
+      {rows && rows.length === 0 && (
+        <div className="rounded-2xl border border-slate-200 bg-white p-5 text-sm text-slate-600">
+          Записей нет.
+        </div>
+      )}
+
+      {rows && rows.length > 0 && (
+        <ul className="space-y-2">
+          {rows.map((r) => (
+            <li
+              key={r.id}
+              className="rounded-2xl border border-slate-200 bg-white p-4 shadow-sm"
+            >
+              <div className="flex items-baseline justify-between gap-3">
+                <div className="min-w-0">
+                  <div className="font-mono text-[11px] text-slate-500">
+                    {new Date(r.created_at).toLocaleString("ru-RU")} ·{" "}
+                    <span>{r.request_id || "—"}</span>
+                  </div>
+                  <div className="mt-1 text-xs text-slate-700">
+                    модель:{" "}
+                    <code className="font-mono">
+                      {r.model_used || "—"}
+                    </code>
+                  </div>
+                </div>
+                {r.project_id && (
+                  <Link
+                    href={`/projects/${r.project_id}`}
+                    className="shrink-0 rounded-md border border-slate-300 bg-slate-50 px-2 py-0.5 text-[10px] font-medium text-slate-700 hover:bg-slate-100"
+                  >
+                    перейти к проекту
+                  </Link>
+                )}
+              </div>
+              {r.source_text && (
+                <details className="mt-2">
+                  <summary className="cursor-pointer text-xs text-slate-500 hover:text-slate-700">
+                    источник
+                  </summary>
+                  <pre className="mt-1 max-h-40 overflow-auto whitespace-pre-wrap rounded-lg bg-slate-50 p-2 text-[11px] text-slate-700">
+                    {r.source_text}
+                  </pre>
+                </details>
+              )}
+              {r.payload != null && (
+                <details className="mt-1">
+                  <summary className="cursor-pointer text-xs text-slate-500 hover:text-slate-700">
+                    payload
+                  </summary>
+                  <pre className="mt-1 max-h-48 overflow-auto whitespace-pre-wrap rounded-lg bg-slate-50 p-2 text-[11px] text-slate-700">
+                    {JSON.stringify(r.payload, null, 2)}
+                  </pre>
+                </details>
+              )}
+            </li>
+          ))}
+        </ul>
+      )}
+
+      <footer className="mt-10 text-center">
+        <Link
+          href="/"
+          className="text-xs text-slate-400 hover:text-slate-600"
+        >
+          ← на главную
+        </Link>
+      </footer>
+    </main>
+  );
+}

frontend/app/page.tsx

@@ -1,24 +1,82 @@
-/** Landing — short explainer + entry to the blueprint flow. */
+"use client";
+
+/** Landing — health badge + four entry tiles. v3.0. */
+
+import Link from "next/link";
+import { useEffect, useState } from "react";
+import { API_URL, APP_NAME } from "@/lib/config";
+
+type HealthState = "loading" | "ok" | "down";
+
+export default function LandingPage() {
+  const [health, setHealth] = useState<HealthState>("loading");
+
+  useEffect(() => {
+    fetch(`${API_URL}/health`)
+      .then((r) => r.json())
+      .then((j) => (j.status === "ok" ? setHealth("ok") : setHealth("down")))
+      .catch(() => setHealth("down"));
+  }, []);
 
-export default function Page() {
   return (
-    <main className="mx-auto max-w-3xl px-6 py-12">
-      <h1 className="text-3xl font-semibold tracking-tight">
-        Virtual Foreman
-      </h1>
-      <p className="mt-3 text-slate-600">
-        Виртуальный Прораб — конструктор тех-карт и сопровождение проектной
-        документации. Загрузите проектную документацию → мы разберём текст
-        по всем страницам и соберём сводку по проекту; дальше можно выбрать
-        конкретные листы и получить их распознавание через VLM.
-      </p>
-
-      <a
-        href="/blueprint"
-        className="mt-6 inline-block rounded-md bg-slate-900 px-4 py-2 text-white shadow hover:bg-slate-800"
-      >
-        Открыть разбор проектной документации →
-      </a>
+    <main className="mx-auto max-w-md px-4 py-10">
+      <header className="mb-8 text-center">
+        <h1 className="text-3xl font-bold tracking-tight text-slate-900">
+          {APP_NAME}
+        </h1>
+        <p className="mt-2 text-sm text-slate-600">
+          Виртуальный Прораб · тех-стек и документация · BY
+        </p>
+        <span
+          className={
+            "mt-4 inline-block rounded-full px-3 py-1 text-xs font-semibold " +
+            (health === "ok"
+              ? "bg-emerald-100 text-emerald-700"
+              : health === "down"
+              ? "bg-rose-100 text-rose-700"
+              : "bg-slate-100 text-slate-600")
+          }
+        >
+          backend: {health === "ok" ? "online" : health === "down" ? "offline" : "проверка..."}
+        </span>
+      </header>
+
+      <nav className="space-y-3">
+        <Tile primary href="/projects">
+          Все проекты
+        </Tile>
+        <Tile href="/projects/new">Новый проект</Tile>
+        <Tile href="/documents">Шаблоны документов</Tile>
+        <Tile href="/history">История инференсов</Tile>
+      </nav>
+
+      <footer className="mt-12 text-center text-xs text-slate-400">
+        v3.0 · project-aware blueprints
+      </footer>
     </main>
   );
 }
+
+function Tile({
+  href,
+  children,
+  primary = false,
+}: {
+  href: string;
+  children: React.ReactNode;
+  primary?: boolean;
+}) {
+  return (
+    <Link
+      href={href}
+      className={
+        "block w-full rounded-2xl py-4 text-center text-sm font-semibold shadow-sm transition " +
+        (primary
+          ? "bg-slate-900 text-white hover:bg-slate-800"
+          : "border border-slate-300 bg-white text-slate-700 hover:bg-slate-50")
+      }
+    >
+      {children}
+    </Link>
+  );
+}

frontend/app/projects/[id]/BlueprintsPanel.tsx

@@ -0,0 +1,156 @@
+"use client";
+
+/** Step A — upload blueprints to a project. v3.0. */
+
+import { useEffect, useRef, useState } from "react";
+import {
+  listProjectUploads,
+  uploadBlueprintV2,
+  type UploadRow,
+} from "@/lib/api";
+
+interface Props {
+  projectId: string;
+  refreshKey: number;
+}
+
+export function BlueprintsPanel({ projectId, refreshKey }: Props) {
+  const [items, setItems] = useState<UploadRow[] | null>(null);
+  const [error, setError] = useState<string | null>(null);
+  const [uploadingName, setUploadingName] = useState<string | null>(null);
+  const fileRef = useRef<HTMLInputElement | null>(null);
+
+  const reload = async () => {
+    setError(null);
+    try {
+      const resp = await listProjectUploads(projectId);
+      setItems(resp.uploads);
+    } catch (e) {
+      setError(e instanceof Error ? e.message : String(e));
+      setItems([]);
+    }
+  };
+
+  useEffect(() => {
+    reload();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [projectId, refreshKey]);
+
+  async function onPick(file: File | undefined) {
+    if (!file) return;
+    setError(null);
+    setUploadingName(file.name);
+    try {
+      await uploadBlueprintV2(file, projectId);
+      await reload();
+    } catch (e) {
+      setError(e instanceof Error ? e.message : String(e));
+    } finally {
+      setUploadingName(null);
+      if (fileRef.current) fileRef.current.value = "";
+    }
+  }
+
+  return (
+    <section className="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm">
+      <header className="mb-3 flex items-center justify-between">
+        <h2 className="text-lg font-semibold">
+          Шаг 1 · чертежи проекта
+        </h2>
+        {items && (
+          <span className="rounded-full bg-slate-100 px-2 py-0.5 text-xs font-medium text-slate-600">
+            файлов: {items.length}
+          </span>
+        )}
+      </header>
+
+      <p className="mb-3 text-xs text-slate-500">
+        Загрузите один или несколько PDF с комплектом рабочих чертежей.
+        Сервер извлечёт native-текст и сохранит листы для последующего
+        разбора.
+      </p>
+
+      <label className="flex w-full cursor-pointer items-center justify-center rounded-xl border-2 border-dashed border-slate-300 bg-slate-50 px-4 py-8 text-sm text-slate-500 hover:bg-slate-100">
+        <input
+          ref={fileRef}
+          type="file"
+          accept="application/pdf,image/png,image/jpeg,image/heic,image/heif,image/webp"
+          className="hidden"
+          onChange={(e) => onPick(e.target.files?.[0])}
+          disabled={Boolean(uploadingName)}
+          data-testid="blueprint-file-input"
+        />
+        {uploadingName
+          ? `Загружаем "${uploadingName}"...`
+          : "Клик или drag PDF (можно несколько раз)"}
+      </label>
+
+      {error && (
+        <div className="mt-3 rounded-xl border border-rose-200 bg-rose-50 p-3 text-xs text-rose-700">
+          {error}
+        </div>
+      )}
+
+      {items && items.length === 0 && (
+        <p className="mt-4 text-xs text-slate-400">Загрузок ещё нет.</p>
+      )}
+
+      {items && items.length > 0 && (
+        <ul className="mt-4 space-y-2 text-sm">
+          {items.map((u) => (
+            <li
+              key={u.upload_id}
+              className="flex items-center justify-between gap-3 rounded-xl border border-slate-200 bg-slate-50 p-3"
+            >
+              <div className="min-w-0">
+                <div className="truncate font-medium text-slate-900">
+                  {u.file_name}
+                </div>
+                <div className="text-[11px] text-slate-500">
+                  {u.page_count} стр. ·{" "}
+                  sha{" "}
+                  <code className="font-mono">
+                    {u.sha256 ? u.sha256.slice(0, 10) : "—"}
+                  </code>{" "}
+                  · статус:{" "}
+                  <span
+                    className={
+                      u.status === "uploaded"
+                        ? "text-emerald-700"
+                        : "text-amber-700"
+                    }
+                  >
+                    {u.status}
+                  </span>
+                </div>
+              </div>
+              <span
+                className={
+                  "shrink-0 rounded-full px-2 py-0.5 text-[10px] font-semibold " +
+                  (u.has_native_text
+                    ? "bg-emerald-100 text-emerald-700"
+                    : "bg-amber-100 text-amber-700")
+                }
+                title={
+                  u.has_native_text
+                    ? "Извлечён native-текст PDF"
+                    : "Скан / без текста — потребуется VLM"
+                }
+              >
+                {u.has_native_text ? "text" : "scan"}
+              </span>
+            </li>
+          ))}
+        </ul>
+      )}
+
+      <button
+        type="button"
+        onClick={reload}
+        className="mt-4 text-xs text-slate-500 underline"
+      >
+        обновить список
+      </button>
+    </section>
+  );
+}

frontend/app/projects/[id]/DocumentationPanel.tsx

@@ -0,0 +1,223 @@
+"use client";
+
+/** Step B — aggregated dokumentatsiya + extract-all. v3.0.
+ *
+ *  Cache UX:
+ *   - cached_summary present && aggregate_sha256 matches persisted
+ *     → show inline + green "Cached · {model}" badge.
+ *   - cached_summary present but aggregate_sha256 differs (new upload)
+ *     → amber "Новый sha — требуется выжимка" banner + button.
+ *   - cached_summary absent
+ *     → empty state + button.
+ */
+
+import { useEffect, useState } from "react";
+import {
+  extractProjectAll,
+  projectDokumentatsiya,
+  type DokumentatsiyaResponse,
+  type ExtractAllResponse,
+} from "@/lib/api";
+import { SummaryBlock } from "./SummaryBlock";
+
+interface Props {
+  projectId: string;
+  refreshKey: number;
+  onUpdated: (r: ExtractAllResponse) => void;
+}
+
+type LoadState =
+  | { kind: "loading" }
+  | { kind: "ready"; data: DokumentatsiyaResponse; cached?: ExtractAllResponse | null }
+  | { kind: "empty" }
+  | { kind: "error"; message: string };
+
+export function DocumentationPanel({ projectId, refreshKey, onUpdated }: Props) {
+  const [state, setState] = useState<LoadState>({ kind: "loading" });
+  const [running, setRunning] = useState(false);
+
+  const reload = async () => {
+    setState({ kind: "loading" });
+    try {
+      const data = await projectDokumentatsiya(projectId);
+      let cached: ExtractAllResponse | null = null;
+      if (data.cached_summary) {
+        // The dokumentatsiya endpoint doesn't surface generated_at; use
+        // a sentinel. The runtime treats this as cache-hit data.
+        cached = {
+          upload_id: projectId,
+          model_used: data.cached_summary_model || "cache",
+          page_count: data.total_pages,
+          generated_at: data.generated_at,
+          summary: data.cached_summary,
+        };
+      }
+      setState({ kind: "ready", data, cached });
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      if (/404/.test(msg) || /no blueprint uploads/.test(msg)) {
+        setState({ kind: "empty" });
+      } else {
+        setState({ kind: "error", message: msg });
+      }
+    }
+  };
+
+  useEffect(() => {
+    reload();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [projectId, refreshKey]);
+
+  const runExtractAll = async (force: boolean) => {
+    setRunning(true);
+    try {
+      const r = await extractProjectAll(projectId, { force });
+      onUpdated(r);
+      // Force re-read so aggregate_sha256 matches the persistence.
+      await reload();
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      setState({ kind: "error", message: msg });
+    } finally {
+      setRunning(false);
+    }
+  };
+
+  if (state.kind === "loading") {
+    return (
+      <section className="rounded-2xl border border-slate-200 bg-white p-5 text-sm text-slate-500 shadow-sm">
+        Шаг 2 · читаем сводный снимок чертежей...
+      </section>
+    );
+  }
+
+  if (state.kind === "empty") {
+    return (
+      <section className="rounded-2xl border border-amber-200 bg-amber-50 p-5 text-sm text-amber-800 shadow-sm">
+        <h2 className="mb-2 text-lg font-semibold">Шаг 2 · документация</h2>
+        <p>
+          К проекту пока не привязан ни один чертёж. Сначала загрузите PDF
+          в&nbsp;шаге&nbsp;1.
+        </p>
+      </section>
+    );
+  }
+
+  if (state.kind === "error") {
+    return (
+      <section className="rounded-2xl border border-rose-200 bg-rose-50 p-5 text-sm shadow-sm">
+        <h2 className="mb-2 text-lg font-semibold text-rose-700">
+          Шаг 2 · документация (ошибка)
+        </h2>
+        <p className="text-rose-700">{state.message}</p>
+      </section>
+    );
+  }
+
+  const { data, cached } = state;
+  const cachedValid = Boolean(cached); // sha equality already
+                                 // enforced server-side: any
+                                 // cached_summary == current sha.
+
+  return (
+    <section className="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm">
+      <header className="mb-3 flex items-center justify-between">
+        <h2 className="text-lg font-semibold">Шаг 2 · документация</h2>
+        <span className="rounded-full bg-slate-100 px-2 py-0.5 text-xs font-medium text-slate-600">
+          sha: <code className="font-mono">{data.aggregate_sha256.slice(0, 10)}</code>
+        </span>
+      </header>
+
+      <div className="mb-4 grid grid-cols-3 gap-2 text-center text-sm">
+        <Stat label="Файлов" value={data.total_uploads} />
+        <Stat label="Стр." value={data.total_pages} />
+        <Stat label="Символов" value={data.total_chars} />
+      </div>
+
+      {data.overall_project_section && (
+        <p className="mb-3 text-xs text-slate-600">
+          Основной раздел проекта:{" "}
+          <span className="font-mono">{data.overall_project_section}</span>
+        </p>
+      )}
+
+      {cachedValid && cached ? (
+        <div className="mb-4 rounded-xl border border-emerald-200 bg-emerald-50 p-4">
+          <div className="mb-2 flex items-center justify-between">
+            <div className="flex items-center gap-2">
+              <span className="rounded-full bg-emerald-200 px-2 py-0.5 text-[10px] font-semibold uppercase text-emerald-900">
+                Cached
+              </span>
+              <span className="text-xs text-emerald-800">
+                модель:{" "}
+                <code className="font-mono">{cached.model_used}</code>
+              </span>
+            </div>
+            <button
+              type="button"
+              onClick={() => runExtractAll(true)}
+              disabled={running}
+              className="rounded-lg border border-emerald-300 bg-white px-3 py-1 text-xs font-semibold text-emerald-800 hover:bg-emerald-100 disabled:opacity-50"
+              title="Принудительный rerun через LLM"
+            >
+              {running ? "обновляем..." : "обновить"}
+            </button>
+          </div>
+          <SummaryBlock s={cached.summary} />
+        </div>
+      ) : (
+        <div className="mb-4 rounded-xl border border-amber-200 bg-amber-50 p-4">
+          <p className="mb-3 text-xs text-amber-800">
+            Кэш сводки пуст или устарел (sha изменился). Запустите
+            полную выжимку по тексту.
+          </p>
+          <button
+            type="button"
+            onClick={() => runExtractAll(false)}
+            disabled={running}
+            className="rounded-lg bg-slate-900 px-3 py-1.5 text-xs font-semibold text-white shadow hover:bg-slate-800 disabled:opacity-50"
+          >
+            {running ? "LLM работает…" : "Сводка по тексту (LLM)"}
+          </button>
+        </div>
+      )}
+
+      {data.upload_summaries.length > 0 && (
+        <div className="mt-4">
+          <div className="mb-1 text-[10px] font-semibold uppercase text-slate-500">
+            Состав загрузок
+          </div>
+          <ul className="space-y-1 text-xs text-slate-700">
+            {data.upload_summaries.map((u) => (
+              <li
+                key={u.upload_id}
+                className="flex items-center justify-between rounded-lg border border-slate-200 bg-slate-50 px-2 py-1"
+              >
+                <span className="truncate">
+                  <span className="font-medium">{u.file_name}</span>{" "}
+                  <span className="text-slate-500">· {u.page_count} стр.</span>
+                </span>
+                {u.section_floor && (
+                  <span className="shrink-0 rounded bg-slate-200 px-1.5 py-0.5 font-mono text-[10px]">
+                    {u.section_floor}
+                  </span>
+                )}
+              </li>
+            ))}
+          </ul>
+        </div>
+      )}
+    </section>
+  );
+}
+
+function Stat({ label, value }: { label: string; value: number }) {
+  return (
+    <div className="rounded-xl border border-slate-200 bg-slate-50 p-2">
+      <div className="text-xl font-semibold tabular-nums text-slate-900">
+        {value}
+      </div>
+      <div className="text-[10px] uppercase text-slate-500">{label}</div>
+    </div>
+  );
+}

frontend/app/projects/[id]/SheetVisionPanel.tsx

@@ -0,0 +1,212 @@
+"use client";
+
+/** Step C — VLM over selected (upload_id, page_no) pairs. v3.0.
+ *
+ *  Pages are grouped by upload so the user always knows which file
+ *  they're picking from. The wire payload is list[SheetExtractPair].
+ */
+
+import { useEffect, useMemo, useState } from "react";
+import {
+  extractProjectSheetsV2,
+  projectDokumentatsiya,
+  type AggregatedPage,
+  type ExtractAllResponse,
+  type SheetExtractPair,
+} from "@/lib/api";
+import { SummaryBlock } from "./SummaryBlock";
+
+interface Props {
+  projectId: string;
+  refreshKey: number;
+  onResult: (r: ExtractAllResponse) => void;
+}
+
+export function SheetVisionPanel({ projectId, refreshKey, onResult }: Props) {
+  const [pages, setPages] = useState<AggregatedPage[]>([]);
+  const [loadingPages, setLoadingPages] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+  const [selected, setSelected] = useState<Set<string>>(new Set());
+  const [running, setRunning] = useState(false);
+  const [result, setResult] = useState<ExtractAllResponse | null>(null);
+
+  useEffect(() => {
+    setLoadingPages(true);
+    setError(null);
+    projectDokumentatsiya(projectId)
+      .then((d) => setPages(d.pages))
+      .catch((e) => setError(e instanceof Error ? e.message : String(e)))
+      .finally(() => setLoadingPages(false));
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [projectId, refreshKey]);
+
+  const byUpload = useMemo(() => {
+    const m = new Map<
+      string,
+      { upload_file_name: string; pages: AggregatedPage[] }
+    >();
+    for (const p of pages) {
+      const cur = m.get(p.upload_id);
+      if (cur) cur.pages.push(p);
+      else
+        m.set(p.upload_id, {
+          upload_file_name: p.upload_file_name,
+          pages: [p],
+        });
+    }
+    return m;
+  }, [pages]);
+
+  const keyFor = (uid: string, pn: number) => `${uid}#${pn}`;
+
+  const toggle = (k: string) =>
+    setSelected((prev) => {
+      const nx = new Set(prev);
+      if (nx.has(k)) nx.delete(k);
+      else nx.add(k);
+      return nx;
+    });
+
+  const runVision = async () => {
+    const pairs: SheetExtractPair[] = Array.from(selected).flatMap((k) => {
+      const [uid, pn] = k.split("#");
+      const pageNo = Number(pn);
+      if (!uid || !Number.isFinite(pageNo) || pageNo < 1) return [];
+      return [{ upload_id: uid, page_no: pageNo }];
+    });
+    if (pairs.length === 0) {
+      setError("Ни одной валидной страницы не выбрано.");
+      return;
+    }
+    setError(null);
+    setRunning(true);
+    try {
+      const r = await extractProjectSheetsV2(projectId, pairs);
+      setResult(r);
+      onResult(r);
+    } catch (e) {
+      setError(e instanceof Error ? e.message : String(e));
+    } finally {
+      setRunning(false);
+    }
+  };
+
+  return (
+    <section className="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm">
+      <header className="mb-3 flex items-center justify-between">
+        <h2 className="text-lg font-semibold">Шаг 3 · VLM по листам</h2>
+        {selected.size > 0 && (
+          <span className="rounded-full bg-slate-100 px-2 py-0.5 text-xs font-medium text-slate-600">
+            выбрано: {selected.size}
+          </span>
+        )}
+      </header>
+
+      <p className="mb-3 text-xs text-slate-500">
+        Сервер прогонит vision-LLM по выбранным листам и вернёт сводную
+        выжимку. Полезно когда native-текст не распознан (скан) или нужна
+        детализация конкретных листов.
+      </p>
+
+      {loadingPages ? (
+        <p className="text-sm text-slate-500">Загружаем карту страниц...</p>
+      ) : pages.length === 0 ? (
+        <p className="text-sm text-slate-400">
+          Сначала загрузите чертёж (шаг&nbsp;1).
+        </p>
+      ) : (
+        <div className="space-y-3">
+          {Array.from(byUpload.entries()).map(([uid, group]) => (
+            <div
+              key={uid}
+              className="rounded-xl border border-slate-200 bg-slate-50 p-3"
+            >
+              <div className="mb-2 truncate text-xs font-semibold text-slate-700">
+                {group.upload_file_name}{" "}
+                <code className="ml-1 font-mono text-[10px] text-slate-500">
+                  {uid.slice(0, 8)}
+                </code>
+              </div>
+              <ul className="grid grid-cols-1 gap-1 md:grid-cols-2">
+                {group.pages.map((p) => {
+                  const k = keyFor(uid, p.page_no);
+                  return (
+                    <li
+                      key={k}
+                      className={
+                        "flex items-start gap-2 rounded-lg border p-2 text-sm " +
+                        (selected.has(k)
+                          ? "border-slate-900 bg-white"
+                          : "border-slate-200 bg-white")
+                      }
+                    >
+                      <input
+                        type="checkbox"
+                        className="mt-0.5"
+                        checked={selected.has(k)}
+                        onChange={() => toggle(k)}
+                      />
+                      <div className="min-w-0 flex-1">
+                        <div className="flex items-baseline gap-2">
+                          <span className="font-mono text-[11px] text-slate-500">
+                            стр. {p.page_no}
+                          </span>
+                          {p.stamp && (
+                            <span className="font-mono text-[11px] font-semibold">
+                              {p.stamp.split(" ")[0]}
+                            </span>
+                          )}
+                        </div>
+                        <div className="truncate text-xs text-slate-800">
+                          {p.title_guess || "—"}
+                        </div>
+                      </div>
+                    </li>
+                  );
+                })}
+              </ul>
+            </div>
+          ))}
+        </div>
+      )}
+
+      <div className="mt-4 flex items-center gap-3">
+        <button
+          type="button"
+          onClick={runVision}
+          disabled={running || selected.size === 0 || loadingPages}
+          className="rounded-lg bg-slate-900 px-3 py-1.5 text-sm font-semibold text-white shadow hover:bg-slate-800 disabled:opacity-50"
+        >
+          {running
+            ? "VLM обрабатывает…"
+            : `VLM по выбранным (${selected.size})`}
+        </button>
+        <button
+          type="button"
+          onClick={() => setSelected(new Set())}
+          disabled={selected.size === 0}
+          className="text-xs text-slate-500 underline disabled:opacity-30"
+        >
+          снять выделение
+        </button>
+      </div>
+
+      {error && (
+        <div className="mt-3 rounded-xl border border-rose-200 bg-rose-50 p-3 text-xs text-rose-700">
+          {error}
+        </div>
+      )}
+
+      {result && (
+        <div className="mt-4 rounded-xl border border-slate-200 bg-slate-50 p-4">
+          <div className="mb-2 text-xs text-slate-500">
+            VLM-сводка · модель{" "}
+            <code className="font-mono">{result.model_used}</code> ·{" "}
+            {result.page_count} лист(а/ов)
+          </div>
+          <SummaryBlock s={result.summary} />
+        </div>
+      )}
+    </section>
+  );
+}

frontend/app/projects/[id]/SummaryBlock.tsx

@@ -0,0 +1,94 @@
+"use client";
+
+/** Shared rendering blocks for project blueprints. v3.0. */
+
+import type { ProjectSummary } from "@/lib/api";
+
+function Stat({ label, value }: { label: string; value: number }) {
+  return (
+    <div className="rounded-xl border border-slate-200 bg-slate-50 p-3">
+      <div className="text-2xl font-semibold tabular-nums text-slate-900">
+        {value}
+      </div>
+      <div className="text-[10px] uppercase text-slate-500">{label}</div>
+    </div>
+  );
+}
+
+interface SummaryBlockProps {
+  s: ProjectSummary;
+}
+
+export function SummaryBlock({ s }: SummaryBlockProps) {
+  return (
+    <div className="space-y-4 text-sm">
+      <div>
+        <div className="text-[10px] font-semibold uppercase text-slate-500">
+          Объект
+        </div>
+        <div className="mt-1 font-medium text-slate-900">{s.object_name}</div>
+        {s.object_address && (
+          <div className="text-slate-600">{s.object_address}</div>
+        )}
+        {s.project_section && (
+          <div className="text-slate-600">
+            Раздел: <span className="font-mono">{s.project_section}</span>
+          </div>
+        )}
+      </div>
+
+      <div className="grid grid-cols-3 gap-2 text-center">
+        <Stat label="Листов" value={s.totals.sheet_count} />
+        <Stat label="Со штампом" value={s.totals.sheets_with_stamp} />
+        <Stat label="Текст. стр." value={s.totals.text_pages} />
+      </div>
+
+      {s.spec_summary && (
+        <div>
+          <div className="text-[10px] font-semibold uppercase text-slate-500">
+            Состав
+          </div>
+          <p className="mt-1 whitespace-pre-wrap text-slate-800">
+            {s.spec_summary}
+          </p>
+        </div>
+      )}
+
+      {s.sheets_index.length > 0 && (
+        <div>
+          <div className="text-[10px] font-semibold uppercase text-slate-500">
+            Штамповый индекс
+          </div>
+          <ul className="mt-2 grid grid-cols-1 gap-x-3 gap-y-1 md:grid-cols-2">
+            {s.sheets_index.map((x, i) => (
+              <li key={`${x.page_no}-${i}`} className="truncate">
+                <span className="text-slate-500">стр. {x.page_no}</span>{" "}
+                <span className="font-mono text-xs">
+                  {x.stamp?.split(" ")[0] ?? "—"}
+                </span>
+                {x.title_guess && (
+                  <span className="ml-1 text-slate-600 truncate">
+                    — {x.title_guess.slice(0, 60)}
+                  </span>
+                )}
+              </li>
+            ))}
+          </ul>
+        </div>
+      )}
+
+      {s.missing_info_prompts.length > 0 && (
+        <div>
+          <div className="text-[10px] font-semibold uppercase text-slate-500">
+            Что уточнить
+          </div>
+          <ul className="mt-2 list-disc space-y-1 pl-5 text-slate-800">
+            {s.missing_info_prompts.map((p, i) => (
+              <li key={i}>{p}</li>
+            ))}
+          </ul>
+        </div>
+      )}
+    </div>
+  );
+}

frontend/app/projects/[id]/page.tsx

@@ -0,0 +1,128 @@
+"use client";
+
+/** /projects/[id] — 3-step wizard for one project. v3.0.
+ *
+ *  - BlueprintsPanel  : upload PDFs, list, status pills
+ *  - DocumentationPanel: aggregated snapshot + extract-all w/ cache UX
+ *  - SheetVisionPanel : per-sheet VLM selection
+ *
+ *  refreshKey is bumped whenever a panel signals a state change
+ *  (new upload, extract-all success, etc), forcing other panels to
+ *  re-hydrate from the canonical snapshot.
+ */
+
+import Link from "next/link";
+import { useEffect, useState } from "react";
+import { useParams } from "next/navigation";
+import { getProject, type ExtractAllResponse, type Project } from "@/lib/api";
+import { BlueprintsPanel } from "./BlueprintsPanel";
+import { DocumentationPanel } from "./DocumentationPanel";
+import { SheetVisionPanel } from "./SheetVisionPanel";
+
+export default function ProjectWizardPage() {
+  const params = useParams<{ id: string }>();
+  const projectId = params?.id ?? "";
+
+  const [project, setProject] = useState<Project | null>(null);
+  const [loadErr, setLoadErr] = useState<string | null>(null);
+  const [refreshKey, setRefreshKey] = useState(0);
+  const [lastResult, setLastResult] = useState<{
+    label: string;
+    r: ExtractAllResponse;
+  } | null>(null);
+
+  useEffect(() => {
+    let cancelled = false;
+    setLoadErr(null);
+    setProject(null);
+    if (!projectId) return;
+    getProject(projectId)
+      .then((p) => {
+        if (!cancelled) setProject(p);
+      })
+      .catch((e) => {
+        if (!cancelled)
+          setLoadErr(e instanceof Error ? e.message : String(e));
+      });
+    return () => {
+      cancelled = true;
+    };
+  }, [projectId]);
+
+  return (
+    <main className="mx-auto max-w-3xl space-y-5 px-4 py-8">
+      <header>
+        <div className="text-xs uppercase text-slate-500">Проект</div>
+        <h1 className="text-2xl font-bold tracking-tight text-slate-900">
+          {project?.object_name || loadErr || "(загрузка...)"}
+        </h1>
+        {project && (
+          <div className="mt-1 text-xs text-slate-500">
+            Договор: <code className="font-mono">{project.contract_no || "—"}</code>{" "}
+            · Заказчик: {project.client || "—"}
+            <span className="ml-2 rounded bg-slate-100 px-1.5 py-0.5 text-[10px] font-mono text-slate-500">
+              {projectId.slice(0, 8)}
+            </span>
+          </div>
+        )}
+        {project?.warning && (
+          <div className="mt-2 rounded-xl border border-amber-200 bg-amber-50 p-2 text-xs text-amber-800">
+            {project.warning}
+          </div>
+        )}
+      </header>
+
+      <BlueprintsPanel
+        projectId={projectId}
+        refreshKey={refreshKey}
+      />
+
+      <DocumentationPanel
+        projectId={projectId}
+        refreshKey={refreshKey}
+        onUpdated={(r) => {
+          setLastResult({ label: "extract-all", r });
+          setRefreshKey((k) => k + 1);
+        }}
+      />
+
+      <SheetVisionPanel
+        projectId={projectId}
+        refreshKey={refreshKey}
+        onResult={(r) => {
+          setLastResult({ label: "extract-sheets", r });
+        }}
+      />
+
+      {lastResult && (
+        <section className="rounded-2xl border border-slate-200 bg-white p-4 text-xs text-slate-600 shadow-sm">
+          <div className="font-semibold text-slate-700">
+            Последний ответ сервера ·{" "}
+            <span className="font-mono">{lastResult.label}</span>
+          </div>
+          <div className="mt-1">
+            модель:{" "}
+            <code className="font-mono">{lastResult.r.model_used}</code>{" "}
+            · {lastResult.r.page_count} стр. ·{" "}
+            {new Date(lastResult.r.generated_at).toLocaleString("ru-RU")}
+          </div>
+        </section>
+      )}
+
+      <footer className="flex justify-between pt-4">
+        <Link
+          href="/projects"
+          className="text-xs text-slate-400 hover:text-slate-600"
+        >
+          ← все проекты
+        </Link>
+        <Link
+          href="/"
+          className="text-xs text-slate-400 hover:text-slate-600"
+        >
+          на главную →
+        </Link>
+      </footer>
+    </main>
+  );
+}

frontend/app/projects/new/page.tsx

@@ -0,0 +1,142 @@
+"use client";
+
+/** /projects/new — create form. After success: navigate to /projects/{id}. v3.0. */
+
+import Link from "next/link";
+import { useRouter } from "next/navigation";
+import { useState } from "react";
+import { createProject, type Project } from "@/lib/api";
+
+type FormState = {
+  contract_no: string;
+  object_name: string;
+  client: string;
+  technical_supervisor: string;
+  contractor: string;
+  work_producer: string;
+  chief_engineer: string;
+};
+
+const initial: FormState = {
+  contract_no: "",
+  object_name: "",
+  client: "",
+  technical_supervisor: "",
+  contractor: "",
+  work_producer: "",
+  chief_engineer: "",
+};
+
+export default function NewProjectPage() {
+  const router = useRouter();
+  const [form, setForm] = useState<FormState>(initial);
+  const [loading, setLoading] = useState(false);
+  const [project, setProject] = useState<Project | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  const handle =
+    <K extends keyof FormState>(k: K) =>
+    (e: React.ChangeEvent<HTMLInputElement>) =>
+      setForm((s) => ({ ...s, [k]: e.target.value }));
+
+  const submit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    setError(null);
+    setProject(null);
+    setLoading(true);
+    try {
+      const resp = await createProject(form);
+      setProject(resp);
+      // Auto-navigate after a brief confirmation beat.
+      setTimeout(() => router.push(`/projects/${resp.id}`), 600);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : "Неизвестная ошибка");
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  const fields: {
+    key: keyof FormState;
+    label: string;
+    placeholder?: string;
+  }[] = [
+    { key: "contract_no", label: "Договор №", placeholder: "12-2026/БН" },
+    { key: "object_name", label: "Объект", placeholder: "Жилой дом по ул. ..." },
+    { key: "client", label: "Заказчик" },
+    { key: "technical_supervisor", label: "Технадзор" },
+    { key: "contractor", label: "Подрядчик" },
+    { key: "work_producer", label: "Производитель работ (прораб)" },
+    { key: "chief_engineer", label: "Главный инженер" },
+  ];
+
+  return (
+    <main className="mx-auto max-w-xl px-4 py-10">
+      <h1 className="mb-6 text-2xl font-bold tracking-tight text-slate-900">
+        Новый проект
+      </h1>
+
+      {project && (
+        <div className="mb-6 rounded-2xl border border-emerald-200 bg-emerald-50 p-5">
+          <p className="font-semibold text-emerald-700">Проект создан</p>
+          <p className="mt-2 text-sm text-slate-700">
+            {project.object_name} (договор {project.contract_no})
+          </p>
+          <p className="mt-1 text-[11px] font-mono text-slate-500">
+            id: {project.id}
+          </p>
+          {project.warning && (
+            <p className="mt-2 text-xs text-amber-700">{project.warning}</p>
+          )}
+          <p className="mt-3 text-xs text-slate-500">
+            Переходим к чертёжной панели...
+          </p>
+        </div>
+      )}
+
+      {!project && (
+        <form onSubmit={submit} className="space-y-4">
+          {fields.map((f) => (
+            <label key={f.key} className="block">
+              <span className="mb-1 block text-sm font-medium text-slate-700">
+                {f.label}
+              </span>
+              <input
+                required
+                value={form[f.key]}
+                onChange={handle(f.key)}
+                placeholder={f.placeholder}
+                className="w-full rounded-xl border border-slate-300 bg-white px-4 py-3 text-base outline-none focus:border-slate-900 focus:ring-2 focus:ring-slate-900/20"
+              />
+            </label>
+          ))}
+          <button
+            type="submit"
+            disabled={loading}
+            className="w-full rounded-2xl bg-slate-900 py-3 font-semibold text-white shadow hover:bg-slate-800 disabled:bg-slate-400"
+          >
+            {loading ? "Создание..." : "Создать проект"}
+          </button>
+        </form>
+      )}
+
+      {error && (
+        <div className="mt-6 rounded-2xl border border-rose-200 bg-rose-50 p-4 text-sm text-rose-700">
+          {error}
+        </div>
+      )}
+
+      <footer className="mt-10 flex justify-between">
+        <Link href="/" className="text-xs text-slate-400 hover:text-slate-600">
+          ← на главную
+        </Link>
+        <Link
+          href="/projects"
+          className="text-xs text-slate-900 hover:text-slate-700"
+        >
+          Все проекты →
+        </Link>
+      </footer>
+    </main>
+  );
+}

frontend/app/projects/page.tsx

@@ -0,0 +1,89 @@
+"use client";
+
+/** /projects — list of all projects. v3.0. */
+
+import Link from "next/link";
+import { useEffect, useState } from "react";
+import { listProjects, type Project } from "@/lib/api";
+
+export default function ProjectsListPage() {
+  const [items, setItems] = useState<Project[] | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    listProjects()
+      .then(setItems)
+      .catch((e) => setError(e instanceof Error ? e.message : "error"));
+  }, []);
+
+  return (
+    <main className="mx-auto max-w-xl px-4 py-10">
+      <header className="mb-6 flex items-center justify-between">
+        <h1 className="text-2xl font-bold tracking-tight text-slate-900">
+          Проекты
+        </h1>
+        <Link
+          href="/projects/new"
+          className="rounded-2xl bg-slate-900 px-4 py-2 text-sm font-semibold text-white shadow hover:bg-slate-800"
+        >
+          + Новый
+        </Link>
+      </header>
+
+      {items === null && !error && (
+        <p className="text-sm text-slate-500">Загрузка...</p>
+      )}
+
+      {error && (
+        <div className="rounded-2xl border border-rose-200 bg-rose-50 p-4 text-sm text-rose-700">
+          {error}
+        </div>
+      )}
+
+      {items && items.length === 0 && (
+        <div className="rounded-2xl border border-slate-200 bg-white p-5 text-sm text-slate-600">
+          Пока нет проектов. Создайте первый — кнопка выше.
+        </div>
+      )}
+
+      {items && items.length > 0 && (
+        <ul className="space-y-2">
+          {items.map((p) => (
+            <li
+              key={p.id}
+              className="rounded-2xl border border-slate-200 bg-white p-4 shadow-sm"
+            >
+              <Link
+                href={`/projects/${p.id}`}
+                className="block hover:opacity-90"
+              >
+                <div className="flex items-start justify-between gap-3">
+                  <div className="min-w-0">
+                    <p className="truncate text-sm font-semibold text-slate-900">
+                      {p.object_name || "(без названия)"}
+                    </p>
+                    <p className="mt-0.5 text-xs text-slate-500">
+                      Договор {p.contract_no || "—"} · {p.client || "—"}
+                    </p>
+                  </div>
+                  <code className="shrink-0 rounded bg-slate-100 px-1.5 py-0.5 text-[10px] text-slate-500">
+                    {p.id.slice(0, 8)}
+                  </code>
+                </div>
+              </Link>
+            </li>
+          ))}
+        </ul>
+      )}
+
+      <footer className="mt-10 text-center">
+        <Link
+          href="/"
+          className="text-xs text-slate-400 hover:text-slate-600"
+        >
+          ← на главную
+        </Link>
+      </footer>
+    </main>
+  );
+}

frontend/lib/api.ts

@@ -344,3 +344,118 @@ export async function extractProjectSheets(
     { pages }
   );
 }
+
+// ===== v2.0 — Project-aware blueprint aggregation =====
+
+export interface UploadRow {
+  upload_id: string;
+  file_name: string;
+  mime_type: string;
+  sha256: string;
+  page_count: number;
+  has_native_text: boolean;
+  status: string;
+  created_at: string | null;
+}
+
+export interface UploadsListResponse {
+  project_id: string;
+  uploads_count: number;
+  uploads: UploadRow[];
+  generated_at: string;
+}
+
+export interface AggregatedPage {
+  upload_id: string;
+  upload_file_name: string;
+  page_no: number;
+  char_count: number;
+  stamp: string | null;
+  title_guess: string | null;
+  is_empty: boolean;
+  section_guess: string | null;
+  text_preview: string;
+}
+
+export interface UploadSummary {
+  upload_id: string;
+  file_name: string;
+  mime_type: string;
+  sha256: string;
+  page_count: number;
+  total_chars: number;
+  section_floor: string | null;
+  sections: string[];
+}
+
+export interface DokumentatsiyaResponse {
+  project_id: string;
+  aggregate_sha256: string;
+  total_uploads: number;
+  total_pages: number;
+  total_chars: number;
+  overall_project_section: string | null;
+  upload_summaries: UploadSummary[];
+  pages: AggregatedPage[];
+  cached_summary: ProjectSummary | null;
+  cached_summary_model: string | null;
+  generated_at: string;
+}
+
+export interface ExtractAllResponse {
+  upload_id: string;       // field reuse — UI sees project_id here
+  model_used: string;
+  page_count: number;
+  generated_at: string;
+  summary: ProjectSummary;
+}
+
+export interface SheetExtractPair {
+  upload_id: string | null;
+  page_no: number;
+}
+
+/** GET /projects/{id}/uploads. */
+export async function listProjectUploads(project_id: string): Promise<UploadsListResponse> {
+  return getJSON<UploadsListResponse>(`/projects/${project_id}/uploads`);
+}
+
+/** GET /projects/{id}/dokumentatsiya. */
+export async function projectDokumentatsiya(project_id: string): Promise<DokumentatsiyaResponse> {
+  return getJSON<DokumentatsiyaResponse>(`/projects/${project_id}/dokumentatsiya`);
+}
+
+/** POST /projects/{id}/extract-all. */
+export async function extractProjectAll(
+  project_id: string,
+  opts: { force?: boolean; max_chars?: number } = {}
+): Promise<ExtractAllResponse> {
+  const qs = new URLSearchParams();
+  if (opts.force) qs.set("force", "true");
+  if (typeof opts.max_chars === "number") qs.set("max_chars", String(opts.max_chars));
+  const path = `/projects/${project_id}/extract-all${qs.toString() ? `?${qs}` : ""}`;
+  return postJSON<ExtractAllResponse>(path, {});
+}
+
+/** POST /projects/{id}/extract-sheets. */
+export async function extractProjectSheetsV2(
+  project_id: string,
+  pairs: SheetExtractPair[]
+): Promise<ExtractAllResponse> {
+  return postJSON<ExtractAllResponse>(
+    `/projects/${project_id}/extract-sheets`,
+    { pages: pairs }
+  );
+}
+
+/** POST /uploads/blueprint (project-scoped upload). */
+export async function uploadBlueprintV2(
+  file: File,
+  project_id: string,
+  opts: { signal?: AbortSignal } = {}
+): Promise<UploadBlueprintStatus> {
+  const form = new FormData();
+  form.append("file", file);
+  form.append("project_id", project_id);
+  return postForm<UploadBlueprintStatus>("/uploads/blueprint", form, opts);
+}