// 旧多画布事务撤销:校验回执有效性与当前后态,恢复文档/关系并创建独立幂等撤销回执。 package platform import ( "database/sql" "encoding/json" "net/http" "strings" ) // undoCanvasTransaction 只支持列出的子图/连接动作,过期或已撤销回执不可再次执行。 func (s *service) undoCanvasTransaction(w http.ResponseWriter, r *http.Request, project, account string) error { if r.Method != http.MethodPost { reject(w, 405, "method_not_allowed") return nil } if !acceptsCanvasV2(r) { reject(w, 409, "canvas_schema_upgrade_required") return nil } key := canvasIdempotencyKey(r) id := r.PathValue("transaction") if !uuidSlugPattern.MatchString(key) || !uuidSlugPattern.MatchString(id) { reject(w, 400, "invalid_transaction_request") return nil } var input struct { ExpectedVersions map[string]int64 `json:"expected_versions"` } if !decode(w, r, &input) { return nil } if len(input.ExpectedVersions) == 0 { reject(w, 428, "version_required") return nil } workspace, board := r.PathValue("workspace"), r.PathValue("material") tx, err := s.db.BeginTx(r.Context(), nil) if err != nil { return err } defer tx.Rollback() _, role, err := lockMaterial(r.Context(), tx, project, workspace, board, account) if err != nil { return err } if role == "viewer" { reject(w, 403, "forbidden") return nil } action := "undo/" + id hash := payloadDigest(input) done, err := transactionRetry(w, r, tx, project, account, board, action, key, hash) if err != nil { return err } if done { return nil } var beforeRaw, versionsRaw, relationsRaw, afterResponse json.RawMessage var originalAction string var expired bool var undone sql.NullTime err = tx.QueryRowContext(r.Context(), `SELECT action,before_state,after_versions,relation_changes,response_body,expires_at<=now(),undone_at FROM canvas_transactions WHERE project=$1 AND workspace_id=$2 AND board_id=$3 AND id=$4 FOR UPDATE`, project, workspace, board, id).Scan(&originalAction, &beforeRaw, &versionsRaw, &relationsRaw, &afterResponse, &expired, &undone) if err != nil { return err } if expired { reject(w, 409, "undo_receipt_expired") return nil } if undone.Valid { reject(w, 409, "transaction_already_undone") return nil } if originalAction != "create_subgraph" && originalAction != "migrate_subgraphs" && originalAction != "create_connection" && !strings.HasPrefix(originalAction, "dissolve_subgraph/") && !strings.HasPrefix(originalAction, "move_members/") { reject(w, 409, "undo_not_supported") return nil } var before []canvasSnapshot var versions map[string]int64 if err = json.Unmarshal(beforeRaw, &before); err != nil { return err } if err = json.Unmarshal(versionsRaw, &versions); err != nil { return err } if len(versions) != len(input.ExpectedVersions) { reject(w, 428, "version_required") return nil } var changes []subgraphRelationChange if err = json.Unmarshal(relationsRaw, &changes); err != nil { return err } // 归档孩子无法按普通素材路径授权,需通过其当前父画布验证编辑权限;关系必须仍等于原 After。 archivedParticipants := map[string]bool{} for _, change := range changes { actual, err := readSubgraphRelation(r, tx, project, workspace, change.After.Child) if err != nil { return err } if actual != change.After { reject(w, 412, "version_conflict") return nil } if actual.Archived { _, role, err := lockMaterial(r.Context(), tx, project, workspace, actual.Parent, account) if err != nil { return err } if role == "viewer" { reject(w, 403, "forbidden") return nil } archivedParticipants[actual.Child] = true } } var recorded struct { Parent canvasSnapshot `json:"parent"` Child *canvasSnapshot `json:"child"` Children []canvasSnapshot `json:"children"` Snapshots []canvasSnapshot `json:"snapshots"` } if err = json.Unmarshal(afterResponse, &recorded); err != nil { return err } // 从原响应的不同形态收集操作后文档,用内容相等而非原版本号判断是否仍可安全栈式撤销。 afterStates := map[string]json.RawMessage{} if recorded.Parent.BoardID != "" { afterStates[recorded.Parent.BoardID] = recorded.Parent.Document } if recorded.Child != nil { afterStates[recorded.Child.BoardID] = recorded.Child.Document } for _, snapshot := range append(recorded.Children, recorded.Snapshots...) { afterStates[snapshot.BoardID] = snapshot.Document } current := map[string]canvasSnapshot{} for id := range versions { if !archivedParticipants[id] { _, role, err := lockMaterial(r.Context(), tx, project, workspace, id, account) if err != nil { return err } if role == "viewer" { reject(w, 403, "forbidden") return nil } } snapshot, err := loadCanvas(r, tx, project, workspace, id) if err != nil { return err } expected, exists := input.ExpectedVersions[id] if !exists { reject(w, 428, "version_required") return nil } // 客户端确认当前版本,服务端还确认当前内容等于原后态,防止覆盖后续独立编辑。 if expected != snapshot.Version || !sameCanvasDocument(snapshot.Document, afterStates[id]) { reject(w, 412, "version_conflict") return nil } current[id] = snapshot } // 全部参与者校验完再恢复关系与快照;版本以当前值加一推进,绝不倒退到历史版本。 for _, change := range changes { if err = writeSubgraphRelation(r, tx, project, workspace, change.Before); err != nil { return err } } beforeIDs := map[string]bool{} updated := []canvasSnapshot{} appliedVersions := map[string]int64{} for _, snapshot := range before { beforeIDs[snapshot.BoardID] = true snapshot.Version = current[snapshot.BoardID].Version + 1 if err = s.saveCanvas(r, tx, project, workspace, snapshot); err != nil { return err } updated = append(updated, snapshot) appliedVersions[snapshot.BoardID] = snapshot.Version } // 原操作前不存在的孩子不删除,归档并使旧版本失效,保留完整数据供恢复。 archived := []string{} for id, snapshot := range current { if beforeIDs[id] { continue } _, err = tx.ExecContext(r.Context(), `UPDATE canvas_subgraphs SET archived_at=now() WHERE project=$1 AND workspace_id=$2 AND parent_board_id=$3 AND child_board_id=$4 AND archived_at IS NULL`, project, workspace, board, id) if err != nil { return err } // Keep the complete child for recovery, but invalidate its old version. snapshot.Version++ if err = s.saveCanvas(r, tx, project, workspace, snapshot); err != nil { return err } archived = append(archived, id) appliedVersions[id] = snapshot.Version } _, err = tx.ExecContext(r.Context(), `UPDATE canvas_transactions SET undone_at=now() WHERE project=$1 AND workspace_id=$2 AND id=$3`, project, workspace, id) if err != nil { return err } var newID string err = tx.QueryRowContext(r.Context(), `SELECT gen_random_uuid()::text`).Scan(&newID) if err != nil { return err } result := response{"transaction_id": newID, "undone_transaction_id": id, "snapshots": updated, "archived_board_ids": archived, "applied_versions": appliedVersions} for _, snapshot := range updated { if snapshot.BoardID == board { result["parent"] = snapshot } } encoded, _ := json.Marshal(result) prior, _ := json.Marshal(current) after, _ := json.Marshal(appliedVersions) _, err = tx.ExecContext(r.Context(), `INSERT INTO canvas_transactions(project,workspace_id,board_id,id,account_id,action,idempotency_key,payload_hash,response_status,response_body,before_state,after_versions) VALUES($1,$2,$3,$4,$5,$6,$7,$8,200,$9,$10,$11)`, project, workspace, board, newID, account, action, key, hash, encoded, prior, after) if err != nil { return err } if err = tx.Commit(); err != nil { return err } setVersion(w, appliedVersions[board]) reply(w, 200, result) return nil } // sameCanvasDocument 解码后重编码比较摘要,忽略 JSON 对象键顺序,无法解码时明确不相等。 func sameCanvasDocument(a, b json.RawMessage) bool { var first, second any if json.Unmarshal(a, &first) != nil || json.Unmarshal(b, &second) != nil { return false } return payloadDigest(first) == payloadDigest(second) }