curriculum-project-hub/docs/adr/0035-restore-keeps-original-name.md

ADR 0035: Restore Keeps The Original Name; Conflict Is A Clear Error

Status

Accepted. Supersedes ADR-0033 (restore de-duplicates the node name on sibling conflict).

Context

ADR-0033 made restore auto-rename to 原名(已恢复) on sibling name conflict so restore never fails. In practice the suffix is unwanted noise - operators expect the original name back and prefer to resolve conflicts themselves.

Decision

Restore clears deletedAt and keeps the node's original name. If an active sibling now occupies the same name (D14 partial unique index), the service throws a 409 name_conflict_on_restore with a human-readable message ("同名节点已存在，请先 重命名现有节点再恢复") - no silent renaming, no suffix. The restore audit records the original name only.