Files
Aislo/B07_DesignDetail/openwebcad/src/helpers/autosave.ts
T
eomsangdonandClaude Opus 5.5 5a1490ddaa fix(527-1): B07 확정 표시 걷음 — 정보칸 「확정/잠정」 배지 · CAD 보기 전용 알림 옛 「확정한 도면 · [수정]」 글 · 저장 실패 글 「확정」 → 「저장」
- [>] 「도면 저장」 단계는 요구 281 · 520-3 그대로(고친 도면만 서버 저장 → 단계 완료 → 이동)
- 서버 끝점 · manifest confirmed 키 = 안쪽 이름이라 그대로(브레인 정함)
- 평면도 설정 모달 배지는 sub5(524) 몫

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-25 14:28:28 +09:00

117 lines
3.9 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);
});
}