Files
Aislo/B07_DesignDetail/openwebcad/src/helpers/autosave.ts
T
eomsangdonandClaude Fable 5 17e14a25ed fix(B07): 편집이 사라지지 않게 하고 확정한 도면을 잠근다
사용자 편의성 점검 15건 중 반영 확정분 12건.

편집 손실 방지
- CAD에 미저장 표시(drawingDirty)를 두고, 도면을 바꾸기 전에 묻는다.
  전에는 그은 선이 경고 없이 사라졌다(실측: 캔버스 서명이 원본과 동일).
- 도면 전환을 겹쳐 눌러도 늦게 온 응답이 화면을 덮지 않게 가드를 뒀다.
- 도면층 삭제·객체 이동을 되돌리기에 실어 Ctrl+Z로 돌아오게 했다.

확정한 도면은 읽기 전용
- runCommand 한 곳에서 보는 명령만 통과시킨다(허용 명시 방식).
- 도면을 실을 때 앞 도면의 그리기 도구를 내린다 — 켜 둔 도구가 확정본에도
  계속 그렸다.
- 확정 버튼 자리를 [현재 도면 확정] / [수정]으로 가른다. 확정 해제는 [수정]
  한 곳뿐 — 되돌리기·색 고르기로 확정이 풀리던 경로를 없앴다.

그 밖
- 잠금 도면층(도각·등고선·계류)은 마우스가 스쳐도 하이라이트하지 않는다.
- 준비 중 도면 7종도 빈 도각으로 열린다(눌리지 않는 회색 버튼 제거).
- 도면층 행이 잘리지 않게 패널을 300px로 넓히고 이름을 줄여 담는다.
- 기본 그리기 색을 검정으로 — 흰 종이에 흰 선이라 안 보였다.
- 색 고르는 동안 변경 통지가 연발하지 않는다.
- 수량표는 앞 단계 산출물이라 도면에서 고치지 못하게 막고 안내한다.
- 자동백업 칸을 도면별로 나눈다 — 되살리면 다른 도면에 붙었다.
- 횡단 장 id를 시작 측점 기준으로 바꿔 구간이 달라져도 옛 확정이 안 붙는다.
- 회사 도각 저장 전에 좌표를 검사하고, 기본 도각으로 되돌리기를 연다.
- 횡단 파일이 없어도 나머지 도면 목록은 남는다.
- 불러오는 중·실패를 화면에 표시한다.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-09-01 19:05:22 +09:00

124 lines
4.2 KiB
TypeScript

/**
* 자동 백업·복구 — 탭이 죽어도 마지막 편집을 잃지 않게 한다.
* 작업본(호스트 저장)과는 다른 층이다. 여기 쓰는 것은 복구 전용 사본이고,
* 되살리는 것은 사용자가 안내를 눌렀을 때뿐이다. 자동으로 도면을 갈아끼우지 않는다.
*/
import { toast } from 'react-toastify';
import { HtmlEvent } from '../App.types';
import type { Entity } from '../entities/Entity';
import {
getEntities,
isDrawingReadOnly,
resetUndoBaseline,
setActiveLayerId,
setEntities,
setLayers,
} from '../state';
import { exportEntitiesAndLayersToJsonString } from './import-export-handlers/export-entities-to-json';
import { getEntitiesAndLayersFromJsonString } from './import-export-handlers/import-entities-from-json';
const RECOVERY_KEY = 'OPEN_WEB_CAD__RECOVERY';
const AUTOSAVE_DEBOUNCE_MS = 5000;
interface RecoveryFile {
savedAt: number;
json: string;
}
let debounceTimer: ReturnType<typeof setTimeout> | undefined;
/** 마지막으로 백업한 객체 배열. setEntities가 매번 새 배열을 만들어 참조로 비교된다 */
let lastBackedUp: Entity[] | null = null;
/**
* 지금 백업이 어느 도면 것인가. 칸을 하나만 쓰면 도면을 넘겨볼 때마다 서로 덮어
* 마지막에 본 것만 남고, 되살리면 **지금 열린 다른 도면 위에 붙는다**
* (2026-09-01 지적). B07 임베드에서는 도면을 실을 때마다 이 값이 바뀐다.
*/
let recoveryScope: string | null = null;
/** 서버 도면을 싣는 동안에는 백업하지 않는다 — 적재가 사용자 백업을 덮어 쓴다. */
let suspended = false;
function recoveryKey(): string {
return recoveryScope ? `${RECOVERY_KEY}__${recoveryScope}` : RECOVERY_KEY;
}
/**
* 백업 칸을 이 도면 것으로 옮긴다 (B07 브리지가 도면을 실을 때 부른다).
* 옮기는 동안은 백업을 멈춘다 — 방금 실은 서버 도면이 사용자 백업을 덮지 않게.
*/
export function setRecoveryScope(drawingId: string | null): void {
recoveryScope = drawingId;
lastBackedUp = null;
suspended = true;
clearTimeout(debounceTimer);
// 적재가 부르는 상태 갱신이 모두 지나간 뒤 다시 연다.
setTimeout(() => {
suspended = false;
}, AUTOSAVE_DEBOUNCE_MS);
}
function readRecovery(): RecoveryFile | null {
try {
const raw = localStorage.getItem(recoveryKey());
return raw ? (JSON.parse(raw) as RecoveryFile) : null;
} catch {
return null;
}
}
async function writeBackup(): Promise<void> {
const entities = getEntities();
if (suspended || entities === lastBackedUp || entities.length === 0) return;
try {
const file: RecoveryFile = {
savedAt: Date.now(),
json: await exportEntitiesAndLayersToJsonString(),
};
localStorage.setItem(recoveryKey(), JSON.stringify(file));
lastBackedUp = entities;
} catch {
// 저장 공간이 없거나 막혀 있으면 조용히 넘어간다 — 편집을 막을 일은 아니다
}
}
export function clearRecovery(): void {
try {
localStorage.removeItem(recoveryKey());
} catch {
// 지우지 못해도 다음 백업이 덮어쓴다
}
}
export async function restoreRecovery(): Promise<void> {
if (isDrawingReadOnly()) {
toast.info('확정한 도면입니다. 되살리려면 [수정]을 먼저 누르세요.');
return;
}
const file = readRecovery();
if (!file) {
toast.info('복구할 백업이 없습니다.');
return;
}
const drawing = await getEntitiesAndLayersFromJsonString(file.json);
setEntities(drawing.entities, true);
setLayers(drawing.layers);
setActiveLayerId(drawing.layers[0].id);
resetUndoBaseline();
toast.success(`백업을 되살렸습니다 (${new Date(file.savedAt).toLocaleString()}).`);
}
/** 시작할 때 한 번 부른다. 백업이 있으면 안내만 띄우고, 되살리기는 사용자가 누른다. */
export function registerAutoSave(): void {
window.addEventListener(HtmlEvent.UPDATE_STATE, () => {
clearTimeout(debounceTimer);
debounceTimer = setTimeout(() => void writeBackup(), AUTOSAVE_DEBOUNCE_MS);
});
const file = readRecovery();
if (!file) return;
toast.info(
`이전 작업 백업이 있습니다 (${new Date(file.savedAt).toLocaleString()}). 눌러서 되살리기.`,
{ autoClose: false, onClick: () => void restoreRecovery() }
);
}