From ee282b61b7c5b6da6f8bcd1defc1c42687409773 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=A2=D0=B8=D0=BC=D1=83=D1=80=20=D0=93=D0=BE=D1=80=D0=BE?=
 =?UTF-8?q?=D0=B4=D0=B5=D1=86=D0=BA=D0=B8=D0=B9?=
 <gorodetskiy.timur@tnsu.kz>
Date: Fri, 23 Oct 2026 09:54:12 +0500
Subject: [PATCH] feat: show current vs new plan before importing works

A file value replaces the planned volume of an existing work. Before the
import the page now lists such works with their current and new volume
and unit, highlighting changes and greying out rows that stay the same,
so the user sees what will be overwritten.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 docs/TEST-PLAN.md                             |  1 +
 .../worksImport/WorksImportPage.module.scss   | 48 +++++++++++++++++
 .../pages/worksImport/WorksImportStep.tsx     |  2 +
 .../pages/worksImport/WorksUpdatesTable.tsx   | 54 +++++++++++++++++++
 .../stroyBot/pages/worksImport/texts.ts       | 16 +++++-
 .../worksImport/worksImportBuilder.test.ts    | 41 ++++++++++++--
 .../pages/worksImport/worksImportBuilder.ts   | 36 +++++++++++--
 .../pages/worksImport/worksImportSave.test.ts |  3 +-
 8 files changed, 190 insertions(+), 11 deletions(-)
 create mode 100644 src/webparts/stroyBot/pages/worksImport/WorksUpdatesTable.tsx

diff --git a/docs/TEST-PLAN.md b/docs/TEST-PLAN.md
index 18ceac5..f2a7923 100644
--- a/docs/TEST-PLAN.md
+++ b/docs/TEST-PLAN.md
@@ -201,6 +201,7 @@
 - [ ] **T-WIM-01** Меню: «Импорт работ из Excel» после «Загрузить работы из сметы»; есть у роли **Е**, у **Р** (без edit0) — нет; в архивном проекте — нет; в завершённом — есть.
 - [ ] **T-WIM-02** Файл с несуществующим объектом → «С ошибками: 1», «Объект 2: «…» не найден внутри «…»», кнопки «Импортировать» нет.
 - [ ] **T-WIM-03** Тестовый файл → «Сверяем с работами объектов…» → «Будет создано работ: 1, обновлён … у существующих: 1», кнопка «Импортировать (работ: 2)».
+- [ ] **T-WIM-03a** У работ, где план уже есть, — таблица «Сейчас → Станет»: изменившийся объём подсвечен со стрелкой ▲/▼ (например, «Арматура» 120 м → 150 м ▲), совпадающий — серым «без изменений». План **заменяется** значением из файла, не складывается. В окне подтверждения — «…плановый объём будет заменён значением из файла». (Проверено 2026-10-23.)
 - [ ] ✍️ **T-WIM-04** «Импортировать» → окно «… будет создано работ: 1, обновлено: 1» → «Сохраняем работы…» → «Импорт завершён: создано работ — 1, обновлено — 1» и ссылка «Открыть «Объекты»». (Проверено 2026-10-22.)
 - [ ] **T-WIM-05** «Объекты» → «Бетонирование» → «Работы»: «Арматура» — 120 м, родитель «Бетон B25» и даты не изменились; «Тестовая работа импорта» — 50 м3, верхний уровень.
 - [ ] ✍️ **T-WIM-06** Тот же файл ещё раз → «создано: 0, обновлено: 2» — работы не задваиваются. (Проверено 2026-10-22.)
diff --git a/src/webparts/stroyBot/pages/worksImport/WorksImportPage.module.scss b/src/webparts/stroyBot/pages/worksImport/WorksImportPage.module.scss
index 8a9a69f..60b1020 100644
--- a/src/webparts/stroyBot/pages/worksImport/WorksImportPage.module.scss
+++ b/src/webparts/stroyBot/pages/worksImport/WorksImportPage.module.scss
@@ -33,3 +33,51 @@
   color: inherit;
   font-weight: 600;
 }
+
+// «Сейчас → станет»: изменившийся план подсвечен, совпадающий — приглушён.
+.updates {
+  display: flex;
+  flex-direction: column;
+  gap: $sp-2;
+}
+
+.updatesTitle {
+  margin: 0;
+  font-size: $fs-sm;
+  font-weight: 600;
+  color: $gold-600;
+}
+
+.updatesTable {
+  border-collapse: collapse;
+  font-size: $fs-sm;
+  background: $white;
+  border: 1px solid $gray-200;
+  border-radius: $r-md;
+
+  th {
+    padding: $sp-2 $sp-3;
+    border-bottom: 1px solid $gray-200;
+    background: $gray-50;
+    font-size: $fs-caption;
+    font-weight: 600;
+    text-align: left;
+    text-transform: uppercase;
+    color: $gray-500;
+  }
+
+  td {
+    padding: $sp-2 $sp-3;
+    border-bottom: 1px solid $gray-100;
+    color: $gray-900;
+  }
+}
+
+.changed {
+  font-weight: 600;
+  background: $gold-50;
+}
+
+.unchanged td {
+  color: $gray-400;
+}
diff --git a/src/webparts/stroyBot/pages/worksImport/WorksImportStep.tsx b/src/webparts/stroyBot/pages/worksImport/WorksImportStep.tsx
index d86a24d..a3c19ac 100644
--- a/src/webparts/stroyBot/pages/worksImport/WorksImportStep.tsx
+++ b/src/webparts/stroyBot/pages/worksImport/WorksImportStep.tsx
@@ -4,6 +4,7 @@ import { IExcelImportCheck } from '../_excelImport/excelImportTypes';
 import { IWorksImportPlan } from './worksImportBuilder';
 import { WorksImportStatus } from './useWorksImport';
 import { WorksImportOutcome } from './WorksImportOutcome';
+import { WorksUpdatesTable } from './WorksUpdatesTable';
 import { WORKS_IMPORT_TEXTS } from './texts';
 import styles from './WorksImportPage.module.scss';
 
@@ -47,6 +48,7 @@ export const WorksImportStep: React.FC<Props> = ({ check, projectId, projectTitl
   return (
     <div className={styles.importBlock}>
       <p className={styles.plan}>{TEXTS.plan(plan.toCreate.length, plan.toUpdate.length)}</p>
+      <WorksUpdatesTable updates={plan.toUpdate} />
       <div>
         <Button variant="accent" onClick={() => startImport().catch(() => undefined)}>
           {TEXTS.button(plan.toCreate.length + plan.toUpdate.length)}
diff --git a/src/webparts/stroyBot/pages/worksImport/WorksUpdatesTable.tsx b/src/webparts/stroyBot/pages/worksImport/WorksUpdatesTable.tsx
new file mode 100644
index 0000000..891d860
--- /dev/null
+++ b/src/webparts/stroyBot/pages/worksImport/WorksUpdatesTable.tsx
@@ -0,0 +1,54 @@
+import * as React from 'react';
+import { isUnchanged, IWorkUpdate, volumeChange, VolumeChange } from './worksImportBuilder';
+import { WORKS_IMPORT_TEXTS } from './texts';
+import styles from './WorksImportPage.module.scss';
+
+const TEXTS = WORKS_IMPORT_TEXTS.updates;
+
+const CHANGE_MARK: Record<VolumeChange, string> = { up: '▲', down: '▼', same: '' };
+
+interface Props {
+  updates: IWorkUpdate[];
+}
+
+function formatVolume(volume: number | undefined, unit: string): string {
+  return volume === undefined ? TEXTS.noPlan : `${volume} ${unit}`.trim();
+}
+
+/** Работы, у которых плановый объём уже есть: что сейчас и что станет после импорта. */
+export const WorksUpdatesTable: React.FC<Props> = ({ updates }) => {
+  if (updates.length === 0) return null;
+
+  return (
+    <div className={styles.updates}>
+      <p className={styles.updatesTitle}>{TEXTS.title}</p>
+      <table className={styles.updatesTable}>
+        <thead>
+          <tr>
+            <th>{TEXTS.columns.row}</th>
+            <th>{TEXTS.columns.work}</th>
+            <th>{TEXTS.columns.object}</th>
+            <th>{TEXTS.columns.current}</th>
+            <th>{TEXTS.columns.next}</th>
+          </tr>
+        </thead>
+        <tbody>
+          {updates.map((update) => {
+            const isSame = isUnchanged(update);
+            return (
+              <tr key={update.rowNumber} className={isSame ? styles.unchanged : undefined}>
+                <td>{update.rowNumber}</td>
+                <td>{update.title}</td>
+                <td>{update.objectPath}</td>
+                <td>{formatVolume(update.previousVolume, update.previousUnit)}</td>
+                <td className={isSame ? undefined : styles.changed}>
+                  {isSame ? TEXTS.noChange : `${formatVolume(update.volume, update.unit)} ${CHANGE_MARK[volumeChange(update)]}`}
+                </td>
+              </tr>
+            );
+          })}
+        </tbody>
+      </table>
+    </div>
+  );
+};
diff --git a/src/webparts/stroyBot/pages/worksImport/texts.ts b/src/webparts/stroyBot/pages/worksImport/texts.ts
index 8cb3cff..c042907 100644
--- a/src/webparts/stroyBot/pages/worksImport/texts.ts
+++ b/src/webparts/stroyBot/pages/worksImport/texts.ts
@@ -15,7 +15,9 @@ export const WORKS_IMPORT_TEXTS = {
     saving: (savedCount: number, total: number): string => `Сохраняем работы… ${savedCount} из ${total}`,
     confirmTitle: 'Импорт работ',
     confirmMessage: (createCount: number, updateCount: number, projectTitle: string): string =>
-      `В проекте «${projectTitle}» будет создано работ: ${createCount}, обновлено: ${updateCount}. Продолжить?`,
+      `В проекте «${projectTitle}» будет создано работ: ${createCount}, обновлено: ${updateCount}` +
+      (updateCount > 0 ? ' — у них плановый объём будет заменён значением из файла' : '') +
+      '. Продолжить?',
     confirm: 'Импортировать',
     cancel: 'Отмена',
     success: (createCount: number, updateCount: number): string =>
@@ -26,6 +28,18 @@ export const WORKS_IMPORT_TEXTS = {
       'Файл можно загрузить снова: уже записанные работы обновятся, а не задвоятся.',
     openObjects: 'Открыть «Объекты»'
   },
+  updates: {
+    title: 'У этих работ плановый объём уже есть — он будет заменён значением из файла:',
+    columns: {
+      row: 'Строка',
+      work: 'Работа',
+      object: 'Объект',
+      current: 'Сейчас',
+      next: 'Станет'
+    },
+    noChange: 'без изменений',
+    noPlan: '—'
+  },
   build: {
     missingFields: (row: number): string => `Строка ${row}: не определены объект, вид работ, единица или плановый объём.`,
     duplicateInFile: (firstRow: number, row: number, title: string): string =>
diff --git a/src/webparts/stroyBot/pages/worksImport/worksImportBuilder.test.ts b/src/webparts/stroyBot/pages/worksImport/worksImportBuilder.test.ts
index 8d1c2ef..7baa9a6 100644
--- a/src/webparts/stroyBot/pages/worksImport/worksImportBuilder.test.ts
+++ b/src/webparts/stroyBot/pages/worksImport/worksImportBuilder.test.ts
@@ -1,4 +1,12 @@
-import { buildImportedWorks, normalizeTitle, objectIdsOf, planWorksImport } from './worksImportBuilder';
+import {
+  buildImportedWorks,
+  isUnchanged,
+  IWorkUpdate,
+  normalizeTitle,
+  objectIdsOf,
+  planWorksImport,
+  volumeChange
+} from './worksImportBuilder';
 import { IExcelImportCheck, IExcelImportRow } from '../_excelImport/excelImportTypes';
 import { IWork } from '../works/worksTypes';
 
@@ -45,9 +53,10 @@ const newWork = makeRow(3, 'Тестовая работа импорта', 'м3'
 
 describe('работы из ответа проверки', () => {
   it('тестовый файл: объект — самый глубокий id строкой, единица — текстом, объём — числом', () => {
+    const objectPath = 'Тестовый объект / Бетонирование';
     expect(buildImportedWorks(makeCheck([armature, newWork]))).toEqual([
-      { rowNumber: 2, objectId: '1517', title: 'Арматура', unit: 'м', volume: 100 },
-      { rowNumber: 3, objectId: '1517', title: 'Тестовая работа импорта', unit: 'м3', volume: 50 }
+      { rowNumber: 2, objectId: '1517', objectPath, title: 'Арматура', unit: 'м', volume: 100 },
+      { rowNumber: 3, objectId: '1517', objectPath, title: 'Тестовая работа импорта', unit: 'м3', volume: 50 }
     ]);
   });
 
@@ -79,11 +88,11 @@ describe('работы из ответа проверки', () => {
 describe('план импорта: создать или обновить', () => {
   const works = buildImportedWorks(makeCheck([armature, newWork]));
 
-  it('«Арматура» уже есть на объекте — обновить её; новой работы нет — создать', () => {
+  it('«Арматура» уже есть на объекте — обновить её (с прежними объёмом и единицей); новой работы нет — создать', () => {
     const existing = new Map([['1517', [makeWork('guid-armature', 'Арматура'), makeWork('guid-other', 'Бетон')]]]);
     const plan = planWorksImport(works, existing);
 
-    expect(plan.toUpdate).toEqual([{ ...works[0], workId: 'guid-armature' }]);
+    expect(plan.toUpdate).toEqual([{ ...works[0], workId: 'guid-armature', previousVolume: 100, previousUnit: 'м' }]);
     expect(plan.toCreate).toEqual([works[1]]);
   });
 
@@ -98,6 +107,28 @@ describe('план импорта: создать или обновить', () =
     expect(planWorksImport(works, existing).toCreate).toHaveLength(2);
   });
 
+  it('сейчас 120, в файле 150 — замена с ростом; 100 — снижение; совпадает — без изменений', () => {
+    const update = (volume: number, unit: string = 'м'): IWorkUpdate => ({
+      ...works[0],
+      volume,
+      unit,
+      workId: 'guid-armature',
+      previousVolume: 120,
+      previousUnit: 'м'
+    });
+    expect(volumeChange(update(150))).toEqual('up');
+    expect(volumeChange(update(100))).toEqual('down');
+    expect(volumeChange(update(120))).toEqual('same');
+    expect(isUnchanged(update(120))).toBe(true);
+    expect(isUnchanged(update(120, 'тн'))).toBe(false);
+  });
+
+  it('у существующей работы не было плана — считаем как 0', () => {
+    const existing = new Map([['1517', [{ ...makeWork('guid-armature', 'Арматура'), volume: undefined as unknown as number }]]]);
+    const [update] = planWorksImport(works, existing).toUpdate;
+    expect(volumeChange(update)).toEqual('up');
+  });
+
   it('на объекте две одноимённые работы — ошибка, ничего не планируем', () => {
     const existing = new Map([['1517', [makeWork('guid-1', 'Арматура'), makeWork('guid-2', 'Арматура')]]]);
     expect(() => planWorksImport(works, existing)).toThrow('Строка 2: на объекте 2 работы «Арматура»');
diff --git a/src/webparts/stroyBot/pages/worksImport/worksImportBuilder.ts b/src/webparts/stroyBot/pages/worksImport/worksImportBuilder.ts
index f3b11be..2c3c60f 100644
--- a/src/webparts/stroyBot/pages/worksImport/worksImportBuilder.ts
+++ b/src/webparts/stroyBot/pages/worksImport/worksImportBuilder.ts
@@ -11,14 +11,34 @@ export interface IImportedWork {
   rowNumber: number;
   /** Id объекта строкой — как в колонке cree9_objectid. */
   objectId: string;
+  /** «Тестовый объект / Бетонирование» — для показа пользователю. */
+  objectPath: string;
   title: string;
   unit: string;
   volume: number;
 }
 
-/** Работа с таким названием на объекте уже есть — обновляем её. */
+/** Работа с таким названием на объекте уже есть — заменяем её плановый объём и единицу. */
 export interface IWorkUpdate extends IImportedWork {
   workId: string;
+  /** Что сейчас в системе — показываем «сейчас → станет» до импорта. */
+  previousVolume: number | undefined;
+  previousUnit: string;
+}
+
+/** Как изменится плановый объём: рост, снижение или без изменений. */
+export type VolumeChange = 'up' | 'down' | 'same';
+
+export function volumeChange(update: IWorkUpdate): VolumeChange {
+  const previous = update.previousVolume ?? 0;
+  if (update.volume > previous) return 'up';
+  if (update.volume < previous) return 'down';
+  return 'same';
+}
+
+/** Обновление ничего не меняет — ни объём, ни единицу. */
+export function isUnchanged(update: IWorkUpdate): boolean {
+  return volumeChange(update) === 'same' && normalizeTitle(update.unit) === normalizeTitle(update.previousUnit);
 }
 
 export interface IWorksImportPlan {
@@ -44,7 +64,11 @@ function buildWork(row: IExcelImportRow): IImportedWork {
   if (!objectId || !title || !unit || volume === undefined) {
     throw new Error(WORKS_IMPORT_TEXTS.build.missingFields(row.row));
   }
-  return { rowNumber: row.row, objectId: String(objectId), title, unit, volume };
+  const objectPath = COL.objects
+    .map((column) => textValue(row, column))
+    .filter(Boolean)
+    .join(' / ');
+  return { rowNumber: row.row, objectId: String(objectId), objectPath, title, unit, volume };
 }
 
 /** Работы файла. Одна и та же работа объекта дважды — ошибка: непонятно, какой объём верный. */
@@ -76,8 +100,12 @@ export function planWorksImport(works: IImportedWork[], existingByObject: Map<st
       (existing) => normalizeTitle(existing.title) === normalizeTitle(work.title)
     );
     if (matches.length > 1) throw new Error(WORKS_IMPORT_TEXTS.build.ambiguous(work.rowNumber, work.title, matches.length));
-    if (matches.length === 1) plan.toUpdate.push({ ...work, workId: matches[0].id });
-    else plan.toCreate.push(work);
+    if (matches.length === 1) {
+      const [existing] = matches;
+      plan.toUpdate.push({ ...work, workId: existing.id, previousVolume: existing.volume, previousUnit: existing.unit });
+    } else {
+      plan.toCreate.push(work);
+    }
   });
   return plan;
 }
diff --git a/src/webparts/stroyBot/pages/worksImport/worksImportSave.test.ts b/src/webparts/stroyBot/pages/worksImport/worksImportSave.test.ts
index 70c99f4..5f7d063 100644
--- a/src/webparts/stroyBot/pages/worksImport/worksImportSave.test.ts
+++ b/src/webparts/stroyBot/pages/worksImport/worksImportSave.test.ts
@@ -24,6 +24,7 @@ function makeWriter(failOnCall?: number): ImportWorksWriter & { writes: IWrite[]
 const work = (rowNumber: number, title: string): IImportedWork => ({
   rowNumber,
   objectId: '1517',
+  objectPath: 'Тестовый объект / Бетонирование',
   title,
   unit: 'м',
   volume: 100
@@ -32,7 +33,7 @@ const work = (rowNumber: number, title: string): IImportedWork => ({
 // Как в тестовом файле: строка 2 — «Арматура» уже есть, строка 3 — новая работа.
 const plan: IWorksImportPlan = {
   toCreate: [work(3, 'Тестовая работа импорта')],
-  toUpdate: [{ ...work(2, 'Арматура'), workId: 'guid-armature' }]
+  toUpdate: [{ ...work(2, 'Арматура'), workId: 'guid-armature', previousVolume: 120, previousUnit: 'м' }]
 };
 
 describe('запись импортированных работ', () => {