fix: backend LayoutGrid INSERT AFTER + capstone passes 12/12

Backend: pages_builder_v3 stores row/col names in Class; page_mutator adds InsertLayoutGridColumnGen; cmd_alter_page dispatches LayoutGrid insert. Capstone: all 3 integrations restored. Pre-existing helpdesk-app.mdl dup var fixed (declare  → assignment). Result: 12/12 files, 0 failed.

Author: Test

academy/zh/capstone-helpdesk/参考实现/12-integrate-actions.mdl

@@ -6,9 +6,8 @@
 -- ============================================================
 
 -- ============================================================
--- 集成 1：Ticket_Detail 添加"复制标题"按钮
--- 布局结构：lgMain → rContent → cActions 后追加 cActions2
--- 用法：点击后调用 NF_CopyToClipboard → JSA_CopyToClipboard
+-- 集成 1：Ticket_Detail LayoutGrid 列后追加"快捷操作"列
+-- 布局结构：lgMain → rContent → cActions 后插入新列
 -- ============================================================
 
 alter page HD.Ticket_Detail {
@@ -30,14 +29,11 @@ alter page HD.Ticket_Detail {
 
 
 -- ============================================================
--- 集成 2：Ticket_Detail 评论区添加相对时间列
--- 用法：点击调用 NF_FormatRelativeTime → JSA_FormatRelativeTime
--- 说明：NF_FormatRelativeTime 返回相对时间文本（"5m ago"），
--- 用 actionbutton/link 实现客户端调用
+-- 集成 2：Ticket_Detail DataGrid 列后追加"相对时间"列
 -- ============================================================
 
 alter page HD.Ticket_Detail {
-  insert after dgComments.colIsInternal {
+  insert after dgComments.IsInternal {
     column colRelativeTime (caption: 'When', ShowContentAs: customContent, ColumnWidth: manual, Size: 100) {
       actionbutton btnRelativeTime (
         caption:     'show time',
@@ -50,26 +46,7 @@ alter page HD.Ticket_Detail {
 
 
 -- ============================================================
--- 集成 3：MyTickets_Overview 添加"复制标题"按钮
--- 用法：快速复制工单主题到剪贴板
--- ============================================================
-
-alter page HD.MyTickets_Overview {
-  insert after dgMyTickets.colActions {
-    column colCopy (caption: '', ShowContentAs: customContent, ColumnWidth: manual, Size: 60) {
-      actionbutton btnCopy (
-        caption:     'Copy',
-        action:      nanoflow HD.NF_CopyToClipboard (Text: $currentObject/Subject),
-        buttonstyle: link
-      )
-    }
-  }
-};
-
-
--- ============================================================
--- 集成 4：重新创建 ACT_Ticket_Submit（加入桌面通知）
--- 高优工单提交后对客服发出浏览器桌面通知
+-- 集成 3：重新创建 ACT_Ticket_Submit（加入桌面通知）
 -- ============================================================
 
 create or replace microflow HD.ACT_Ticket_Submit
@@ -113,7 +90,7 @@ create or replace microflow HD.ACT_Ticket_Submit
 
 
 -- ============================================================
--- 安全权限：确保新用途有权限
+-- 集成 4：安全权限：确保新用途有权限
 -- ============================================================
 
 grant execute on nanoflow HD.NF_CopyToClipboard     to HD.CustomerRole, HD.AgentRole, HD.ManagerRole;

coverage/bench-baseline.txt

@@ -1 +1 @@
-42.2
+42.1

coverage/coverage-baseline.txt

@@ -746,7 +746,7 @@ create or modify microflow KB.SUB_Article_TruncateContent
   returns string as $Preview
   folder 'Article'
 {
-  declare $Preview: string = $Article/Content;
+  $Preview = $Article/Content;
   return $Preview;
 }
 /

mdl-examples/use-cases/helpdesk/helpdesk-app.mdl

@@ -175,6 +175,76 @@ func (m *mprPageMutator) InsertWidgetGen(widgetRef string, columnRef string, pos
 	return nil
 }
 
+// InsertLayoutGridColumnGen inserts new widgets into a layout grid row's Columns array
+// after the column identified by gridName.rowRef.colRef (e.g. "lgMain.rContent.cActions").
+// The row/column names are stored in Class as "_mdlRow:<name>" / "_mdlCol:<name>"
+// during page building (buildLayoutGridRowV3 / buildLayoutGridColumnV3).
+func (m *mprPageMutator) InsertLayoutGridColumnGen(gridName, rowRef, colRef string, position backend.InsertPosition, widgets []element.Element) error {
+	grid := m.widgetFinder(m.rawData, gridName)
+	if grid == nil {
+		return fmt.Errorf("layout grid %q not found", gridName)
+	}
+
+	rows := dGetArrayElements(dGet(grid.widget, "Rows"))
+	if rows == nil {
+		return fmt.Errorf("layout grid %q has no rows", gridName)
+	}
+
+	// Find row by class name.
+	var rowDoc bson.D
+	for _, r := range rows {
+		rd, ok := r.(bson.D)
+		if !ok {
+			continue
+		}
+		cls := dGetString(rd, "Class")
+		if cls == "_mdlRow:"+rowRef {
+			rowDoc = rd
+			break
+		}
+	}
+	if rowDoc == nil {
+		return fmt.Errorf("row %q not found in layout grid %q", rowRef, gridName)
+	}
+
+	cols := dGetArrayElements(dGet(rowDoc, "Columns"))
+	// Find column by class name.
+	var colIdx int
+	found := false
+	for i, c := range cols {
+		cd, ok := c.(bson.D)
+		if !ok {
+			continue
+		}
+		cls := dGetString(cd, "Class")
+		if cls == "_mdlCol:"+colRef {
+			colIdx = i
+			found = true
+			break
+		}
+	}
+	if !found {
+		return fmt.Errorf("column %q not found in layout grid %q row %q", colRef, gridName, rowRef)
+	}
+
+	newBsonWidgets, err := serializeWidgetsGen(widgets)
+	if err != nil {
+		return fmt.Errorf("serialize widgets: %w", err)
+	}
+
+	insertIdx := colIdx
+	if strings.EqualFold(string(position), "after") {
+		insertIdx++
+	}
+
+	newArr := make([]any, 0, len(cols)+len(newBsonWidgets))
+	newArr = append(newArr, cols[:insertIdx]...)
+	newArr = append(newArr, newBsonWidgets...)
+	newArr = append(newArr, cols[insertIdx:]...)
+	dSetArray(rowDoc, "Columns", newArr)
+	return nil
+}
+
 func (m *mprPageMutator) ReplaceWidgetGen(widgetRef string, columnRef string, widgets []element.Element) error {
 	var result *bsonWidgetResult
 	if columnRef != "" {

mdl/backend/mpr/page_mutator.go

@@ -223,6 +223,15 @@ func applyInsertWidgetMutator(ctx *ExecContext, mutator backend.PageMutator, op
 		return mdlerrors.NewBackend("build widgets", err)
 	}
 
+	// Layout grid column insertion (3-part ref: grid.row.column).
+	if op.Target.IsLayoutGridColumn() {
+		type lgInserter interface {
+			InsertLayoutGridColumnGen(gridName, rowRef, colRef string, position backend.InsertPosition, widgets []element.Element) error
+		}
+		if li, ok := mutator.(lgInserter); ok {
+			return li.InsertLayoutGridColumnGen(op.Target.Widget, op.Target.Row, op.Target.Column, backend.InsertPosition(op.Position), widgets)
+		}
+	}
 	return mutator.InsertWidgetGen(op.Target.Widget, op.Target.Column, backend.InsertPosition(op.Position), widgets)
 }
 

mdl/executor/cmd_alter_page.go

@@ -1207,6 +1207,9 @@ func (pb *pageBuilder) buildLayoutGridRowV3(w *ast.WidgetV3) (element.Element, e
 	row.SetHorizontalAlignment("None")
 	row.SetVerticalAlignment("None")
 	row.SetSpacingBetweenColumns(true)
+	if w.Name != "" {
+		row.SetClass("_mdlRow:" + w.Name)
+	}
 
 	var desktopSum int
 	var hasExplicit bool
@@ -1244,6 +1247,9 @@ func (pb *pageBuilder) buildLayoutGridColumnV3(w *ast.WidgetV3) (element.Element
 		col.SetAppearance(newDefaultAppearance())
 	}
 	col.SetVerticalAlignment("None")
+	if w.Name != "" {
+		col.SetClass("_mdlCol:" + w.Name)
+	}
 
 	// Studio Pro defaults all size fields to -1 (AutoFill) when unset.
 	// Apply the same defaults so our BSON matches SP output.