Active operational document active / storage: active Document metadata and private storage reference remain visible to authorized tenant users. | EntersA document is uploaded, scanned, linked, and not under deletion review.Exit criteriaContract expiry, tenant request, or owner review moves it to retained or deletion review. | Document controller | Normal read/update policies apply; no deletion job is implied.Export: Included in tenant export metadata; signed URLs are not generated from this view. | ready |
Retained for statutory or operational window retained / storage: retained Document remains kept after active use because retention period has not expired. | EntersContract or compliance record ends but retention period still applies.Exit criteriaRetention window ends and no legal/audit hold is active. | Retention owner | Read-only posture preferred; destructive jobs stay disabled until review.Export: Metadata exportable; private file access still requires separate authorization. | ready |
Retention or legal hold retention_hold / storage: held Deletion is blocked while legal, audit, compliance, or security hold reason exists. | EntersA human owner records a hold reason before any erase workflow.Exit criteriaHold owner clears the reason and records review evidence. | Audit ownerBlocks deletion preview | Deletion preview must show the blocker and future jobs must skip the document.Export: Redacted metadata can be reported; raw file access remains controlled. | blocked |
Soft-deleted metadata soft_deleted / storage: retained User-facing record is hidden but metadata and storage object remain recoverable. | EntersAn authorized user archives/removes the document without final erase approval.Exit criteriaReview owner restores it or moves it to deletion review after cooling off. | Tenant admin | RLS still applies; storage erasure and search purge remain separate explicit steps.Export: Included as deleted metadata in tenant export when legally required. | needs review |
Deletion review deletion_review / storage: retained Human reviewer confirms export coverage, hold status, and downstream purge plan. | EntersTenant deletion or subject deletion preview identifies eligible document records.Exit criteriaOwner approves or rejects the future destructive job with rationale. | Retention ownerBlocks deletion preview | Preview-only in this patch; no queue, storage delete, or provider call is made.Export: Export coverage is verified before any future erase step. | needs review |
Storage erase pending storage_erase_pending / storage: erase_pending Metadata indicates the private object would need erasure in a future controlled job. | EntersDeletion review approves object erasure and no hold remains.Exit criteriaFuture production job records storage_erased_at and no signed URL is issued. | Storage ownerBlocks deletion preview | Not executable in preview; documents the future destructive boundary only.Export: Export records the erase request and object reference summary, not the file body. | blocked |
Search purge pending search_purge_pending / storage: erased Storage erasure has been represented but derived search/index data still needs purge. | EntersFuture storage erasure completes before search provider/index purge evidence.Exit criteriaFuture search delete-by-tenant/source and rebuild evidence is recorded. | Search ownerBlocks deletion preview | Search deletion remains an explicit provider boundary, not an implicit side effect.Export: Derived index records are not exported; purge evidence is audit metadata only. | blocked |
Erased with minimal metadata retained erased_metadata_retained / storage: erased Private object is represented as erased while minimal audit metadata remains. | EntersFuture storage and search purge evidence is complete.Exit criteriaAudit-retention window expires or regulator/human review requires extension. | Audit owner | Only minimal immutable deletion evidence remains visible to authorized reviewers.Export: Export includes deletion evidence, not document content or signed access. | ready |