docs: annotate Foundry source and deployment lifecycle in Chinese [skip ci]
This commit is contained in:
@@ -1,3 +1,4 @@
|
||||
// frame 子图扩展与普通快照的所有权守卫,防止绕开多画布事务改写关系。
|
||||
package platform
|
||||
|
||||
import (
|
||||
@@ -8,6 +9,8 @@ import (
|
||||
"strings"
|
||||
)
|
||||
|
||||
// validCanvasFrameExtensions 仅允许 v2 frame 携带子图、端口和折叠展示配置,检查形状与本地 ID 唯一性。
|
||||
// 端口 nodeId 的跨文档存在性留给持锁关系命令验证。
|
||||
func validCanvasFrameExtensions(d map[string]any, v2 bool) bool {
|
||||
for _, key := range []string{"subgraph", "ports", "presentation"} {
|
||||
value, exists := d[key]
|
||||
@@ -74,6 +77,7 @@ func validCanvasFrameExtensions(d map[string]any, v2 bool) bool {
|
||||
return true
|
||||
}
|
||||
|
||||
// canvasNodeData 从已规范化文档提取 id→data;依赖节点形状已验证,不适合直接读取未校验请求。
|
||||
func canvasNodeData(raw json.RawMessage) map[string]map[string]any {
|
||||
var doc map[string]any
|
||||
_ = json.Unmarshal(raw, &doc)
|
||||
@@ -88,6 +92,7 @@ func canvasNodeData(raw json.RawMessage) map[string]map[string]any {
|
||||
|
||||
// Ordinary saves cannot create, replace, detach or retarget ownership/ports.
|
||||
// Cross-board commands validate these changes while holding the workspace lock.
|
||||
// validateCanvasRelations 在工作区锁下将新快照与数据库活跃子图关系比较,普通保存不得删除/换绑 frame 或端口。
|
||||
func validateCanvasRelations(r *http.Request, tx *sql.Tx, project, workspace, board string, before, after json.RawMessage) (bool, error) {
|
||||
old, next := canvasNodeData(before), canvasNodeData(after)
|
||||
rows, err := tx.QueryContext(r.Context(), `SELECT frame_id,child_board_id::text FROM canvas_subgraphs WHERE project=$1 AND workspace_id=$2 AND parent_board_id=$3 AND archived_at IS NULL`, project, workspace, board)
|
||||
@@ -115,6 +120,7 @@ func validateCanvasRelations(r *http.Request, tx *sql.Tx, project, workspace, bo
|
||||
return false, nil
|
||||
}
|
||||
}
|
||||
// 新增伪子图、无关系的非空端口,或把本地图节点挂进已拥有独立子画布的 frame 都拒绝。
|
||||
for id, d := range next {
|
||||
if sub, exists := d["subgraph"]; exists {
|
||||
m, _ := sub.(map[string]any)
|
||||
@@ -130,6 +136,7 @@ func validateCanvasRelations(r *http.Request, tx *sql.Tx, project, workspace, bo
|
||||
}
|
||||
}
|
||||
// A child node referenced by its parent's ports must not disappear or change kind.
|
||||
// 若当前画布是孩子,还要保持父端口引用的节点存在且种类不变;无父关系则无需此检查。
|
||||
var parentRaw json.RawMessage
|
||||
err = tx.QueryRowContext(r.Context(), `SELECT m.canvas_document FROM canvas_subgraphs s JOIN materials m ON m.project=s.project AND m.workspace_id=s.workspace_id AND m.id=s.parent_board_id WHERE s.project=$1 AND s.workspace_id=$2 AND s.child_board_id=$3 AND s.archived_at IS NULL`, project, workspace, board).Scan(&parentRaw)
|
||||
if err == sql.ErrNoRows {
|
||||
@@ -155,6 +162,7 @@ func validateCanvasRelations(r *http.Request, tx *sql.Tx, project, workspace, bo
|
||||
return true, nil
|
||||
}
|
||||
|
||||
// validCanvasPortHandle 接受四个基础方向,或指向另一个已命名端口的 port:<id>。
|
||||
func validCanvasPortHandle(value any) bool {
|
||||
if canvasChoice(value, "top", "right", "bottom", "left") {
|
||||
return true
|
||||
|
||||
Reference in New Issue
Block a user