V3 S1-S2 : corbeille + versions + extract générique

S1 filet (backend + mobile) : corbeille 30j (deleted_at réutilisé,
trash/restore récursifs, purge auto serveur), versions N=3 à chaque
overwrite, ops outbox trash/restore/purge (delete legacy mappé), Room
v19 (trashed_at), Deleters -> trash, écran Corbeille, walk guards.

S2 extract (backend) : package extract (règles FR stdlib, corpus
testé), resource_facts 000019 (origin auto/user), hook worker OCR +
backfill boot, GET /files/:id/facts (viewer+).

Contrat docs/api-v1.md étendu, V3.md (vision + plan).
This commit is contained in:
venture
2026-09-26 10:14:07 +02:00
parent a34220bf2d
commit 95b4cf79cf
75 changed files with 5220 additions and 119 deletions
+61 -7
View File
@@ -25,6 +25,12 @@ const (
OpRevokeLink = "revoke_link"
// V2 placements : un device signale la présence de ses octets.
OpReportBytes = "report_bytes"
// V3 corbeille (P1) : trash = soft (restaure via restore), purge = hard.
// delete_resource (legacy) est mappé vers trash_resource (même sémantique
// d'idempotence, cf. applyTrashOp).
OpTrashResource = "trash_resource"
OpRestoreResource = "restore_resource"
OpPurgeResource = "purge_resource"
)
// SyncOperation is one outbox entry (shadow of mobile PendingOperationRow).
@@ -200,7 +206,7 @@ func validateSyncOp(op *SyncOperation) error {
switch op.Operation {
case OpCreateResource, OpUpdateMetadata, OpMoveResource, OpDeleteResource,
OpShare, OpRevokeShare, OpUpdateShare, OpCreateLink, OpRevokeLink,
OpReportBytes:
OpReportBytes, OpTrashResource, OpRestoreResource, OpPurgeResource:
default:
return errors.New("unknown operation " + op.Operation)
}
@@ -311,11 +317,13 @@ func (s *Resources) applySyncOp(ownerID, deviceID string, op *SyncOperation) err
}
return s.Repo.MoveResource(ownerID, resourceID, p.ToFolderResourceID)
case OpDeleteResource:
// A8 : delete owner-only. Ligne vivante d'autrui → NOT_FOUND halt
// (pas de applied silencieux). Aucune ligne vivante (jamais existé,
// ou déjà supprimée par son owner) → no-op idempotent : l'état
// terminal (absente) est déjà atteint, le rejeu reste sûr.
case OpDeleteResource, OpTrashResource:
// V3 : delete_resource (legacy) = trash_resource. A8 : owner-only.
// Ligne vivante d'autrui → NOT_FOUND halt (pas de applied
// silencieux). Aucune ligne (jamais existé, déjà trashée/purgée par
// son owner) → no-op idempotent : l'état terminal est atteint.
// Note : une ressource déjà trashée reste trashée (re-trash = no-op
// via TrashResource qui ne touche que deleted_at IS NULL).
exists, err := s.Repo.ExistsOwner(ownerID, resourceID)
if err != nil {
return err
@@ -329,7 +337,53 @@ func (s *Resources) applySyncOp(ownerID, deviceID string, op *SyncOperation) err
}
return repository.ErrNotFound
}
return s.Repo.SyncDelete(ownerID, resourceID)
return s.Repo.TrashResource(ownerID, resourceID)
case OpRestoreResource:
// Owner-only (live ou trashé). Absente → no-op (rien à restaurer,
// l'état terminal — visible — ne peut pas être atteint autrement,
// mais halter casserait la convergence d'un restore rejoué après
// purge... non : après purge la ligne n'existe plus, le restore est
// sans objet → no-op documenté). Vivante d'autrui → NOT_FOUND halt.
owned, err := s.Repo.ExistsOwnerAny(ownerID, resourceID)
if err != nil {
return err
}
if !owned {
if _, err := s.Repo.GetResourceOwner(resourceID); err != nil {
if errors.Is(err, repository.ErrNotFound) {
return nil
}
return err
}
return repository.ErrNotFound
}
return s.Repo.RestoreResource(ownerID, resourceID)
case OpPurgeResource:
// Owner-only (live ou trashé). Absente → no-op idempotent.
// Vivante d'autrui → NOT_FOUND halt. Octets supprimés best-effort.
owned, err := s.Repo.ExistsOwnerAny(ownerID, resourceID)
if err != nil {
return err
}
if !owned {
if _, err := s.Repo.GetResourceOwner(resourceID); err != nil {
if errors.Is(err, repository.ErrNotFound) {
return nil
}
return err
}
return repository.ErrNotFound
}
purged, err := s.Repo.PurgeResource(ownerID, resourceID)
if err != nil {
return err
}
for _, pid := range purged {
s.removePhysical(ownerID, pid)
}
return nil
case OpShare, OpUpdateShare:
return s.applyShareOp(ownerID, resourceID, op)