update

db/migrations/2026-09-22-03-entity-key-unique.sql

@@ -4,8 +4,11 @@
 -- 单表之后没有 upsert 阶段，只剩入库时的「先查后插」；一次瞬时读失败或多实例并发，
 -- 就会留下两行，且两行都会通过审核进入公开视图 —— 前台出现重复内容。
 --
--- 部分索引（WHERE is_deleted = 0）：与 RunwayEntityState / StreetSnapEntityState 的查询口径一致，
--- 软删的旧实体键不再占用，允许同实体重新入库。
+-- 部分索引（WHERE is_deleted = 0）：仅约束活着行，保证「同一实体至多一行活着」。
+-- 注：入库服务层 RunwayEntityState / StreetSnapEntityState 现已**不再**以 is_deleted = 0 过滤，
+-- 软删实体也会被查到并由 worker 跳过重爬（「删除即永久」）。本索引仍保持部分索引是为了
+-- 兼容存量「软删行同键共存」的数据、避免建全量唯一索引时因历史重复而失败；结构性唯一性靠它兜底，
+-- 行为上的「删除即永久」由服务层查重保证。
 
 -- 建索引前先体检：有重复则中止，避免索引创建失败留下半成品状态。
 DO $$