如何为层级结构的复合表单传递并管理数据？

场景与字段定义 #

开发一款支持多层级嵌套结构的制造明细维护App，明细可包含子明细，子明细允许更深层级嵌套。明细类字段分为三类：

class Detail {
  // ---- 可修改字段 ----
  String orderNumber;
  String name;
  String? mainInformation;
  String? drawingImagePath;
  DateTime? drawingExpirationDate;
  String? regularImagePath;

  // --- 逻辑关键字段（用于删除按钮展示、层级关系管理）---
  int? id;
  List<int> subDetailIds;
  int? parentId;

  // --- 表单不可修改字段 ---
  String? comment;
  String? techProcess;
  DetailType type;
  DetailStatus status;
  DateTime createdAt;
  DateTime modifiedAt;
}

核心业务规则 #

• 新增子明细仅在表单提交时写入数据库，未提交的子明细删除只需移除对应的编辑字段
• 编辑模式下仅展示当前明细及一级子明细，删除子明细会连带删除其下所有层级
• 子明细列表支持展开/收起操作

已尝试方案及问题 #

1. 全控制器方案：将所有明细数据存入TextEditingController，包括无需编辑的字段，导致逻辑冗余，维护成本高
2. 对象方案：直接传递完整Detail对象展示数据，但未使用控制器管理输入状态，展开/收起子明细时，已修改的数据会丢失

当前思路与困扰 #

采用混合方案：用TextEditingController管理可修改字段，用DTO维护id/parentId等逻辑关系，已实现DetailFormManager，但新增明细需要生成临时ID，存在ID冲突或转换复杂的困扰

优化建议 #

临时ID的优雅处理 #

• 使用负整数序列作为临时ID（例如-1、-2、-3...），与数据库生成的正整数正式ID做区分。提交表单时，过滤掉所有带临时ID的明细，由数据库分配正式ID后，再更新层级关系中的subDetailIds和parentId
• 或使用UUID作为临时ID，提交时替换为数据库返回的正式ID，彻底避免ID冲突问题

结构化表单状态管理 #

1. 拆分状态载体：
   • 为每个可编辑字段创建独立的TextEditingController，仅负责用户可输入内容的状态管理
   • 设计FormDetailDTO类整合状态：

     class FormDetailDTO {
       // 可编辑字段控制器
       final TextEditingController orderNumberCtrl;
       final TextEditingController nameCtrl;
       final TextEditingController? mainInfoCtrl;
       // ... 其他可编辑字段控制器
     
       // 逻辑关键字段
       String? tempId; // 或int? tempId，用负整数/UUID
       List<String> subDetailTempIds;
       String? parentTempId;
     
       // 不可修改字段（只读）
       final String? comment;
       final String? techProcess;
       final DetailType type;
       // ... 其他不可修改字段
     }
     

2. 层级状态维护：
   • 用列表维护当前明细的一级子明细对应的FormDetailDTO实例，展开/收起仅控制UI显示，不销毁DTO实例，确保修改的数据不会丢失
   • 嵌套子明细的状态可以通过subDetailTempIds关联其他FormDetailDTO，形成内存中的层级结构
3. 提交转换逻辑：
   • 提交时遍历所有FormDetailDTO，将控制器的文本值、逻辑字段、不可修改字段整合为Detail对象
   • 批量提交后，用数据库返回的正式ID替换临时ID，更新所有层级关系中的ID引用

额外优化点 #

• 对于DateTime类型的可编辑字段（如drawingExpirationDate），使用专门的日期选择器组件绑定状态，避免手动输入格式错误
• 子明细删除操作：直接从FormDetailDTO列表中移除对应实例，同时递归清理其关联的所有嵌套子DTO，确保内存状态与UI一致
• 表单验证：为每个可编辑字段的控制器绑定验证逻辑，实时反馈输入错误

内容的提问来源于stack exchange，提问作者vkarp