SuperAPI AI 工具集

ffca-cross-feature

编程与开发

查看项目

更新于 10-29 11:45

技能介绍

FFCA Cross-Feature 是一个面向 FFCA(Flutter 特性驱动架构)项目的工作流技能,专注于“一个功能需要另一个功能”时的处理方式。资料说明,相关模式文档位于插件的 references/ffca/ 目录,在把两个功能耦合起来之前应先阅读所引用的章节。

允许的耦合方式 资料规定功能之间只有两种耦合位置,且各为单向:

  • 领域到领域:消费方功能的 domain 可以依赖提供方功能的 domain,例如 cart_domain 依赖 product_domain。参见 references/ffca/domain.md 的“Composing features”一节。
  • 表现到表现:一个 presentation 包可以使用另一个功能 presentation 包中的公开 widget,但需满足下文三个条件。参见 references/ffca/presentation.md 的“Sharing a widget across features”一节。 资料明确:数据层不得跨功能获取数据,任何层都不得依赖另一功能的 data 包。

共享数据

  • 通过 id 实现松散耦合(Summary 模式):当功能存储对另一功能模型的引用时,只存 id。读模型持有完整对象(如 Cart 含 List<Product>),存储的摘要持有 id(如 CartSummary 含 List<String>)。仓库读写摘要,仅在创建时接收完整对象。参见 domain.md 的“Storing data”,并按 references/code_templates/domain_templates.md 中的形状调整。
  • 用 Query 组合仓库:为从两个功能组装出已填充的模型,在消费方功能的 domain 中新增一个 Query,接收两个仓库接口。参见 domain.md 的“Reading the populated object”。Query 应留在消费方而非提供方:购物车功能不感知商品如何存储,商品功能也不感知购物车的存在。
  • 在仓库内归一化,而非在 Query 中:当 API 返回属于另一功能的嵌套对象时,在 data 仓库内部拆分,该仓库可以依赖另一功能的 domain 接口。参见 references/ffca/faq.md 的“Dealing with nested objects”。DTO 到 domain 的映射在消费方 data 包中有意重复,这是用 DRY 换取有界上下文的刻意取舍。 资料还提醒:不要把这些类称作“use cases”,它们是 Commands 和 Queries。参见 domain.md 的“Business rules”。

共享 widget 资料指出,拥有 Cubit 的 widget 并不是独立功能,它位于所属功能的 presentation 包中并通过 barrel 导出。将它放到另一功能界面上有两种方式,区别在于由谁放置:

  • 窄 barrel 直接导入,需满足三个条件(均出自 presentation.md 的“Sharing a widget across features”):widget 拥有自己的 barrel,消费方导入 package:cart_presentation/cart_badge.dart,绝不导入主 barrel cart_presentation.dart;barrel 保持窄小,其传递导入不得触及该功能的 modules 或 screens,走主 barrel 会让消费方获得该功能所有 screen 和 Cubit,并破坏下游的延迟加载;不得有循环,若两个功能互相需要对方的 widget,应把共享部分下沉到第三个包,而非横向导入。
  • 由 app 填充的 slot:消费方功能完全不感知另一个功能的存在,它声明一个可为空的 Widget 参数,由 app 提供,与导航采用同样的反转思路。slot 按其位置命名(如 trailingAction),默认为空,每个模块最多两个 slot。参见 presentation.md 的“Or let the app place it”。
  • 如何选择:当 widget 属于 app 外壳(如 app bar 中的购物车徽章),用 slot;当 widget 确实是消费界面的一部分时,用直接导入。参见 presentation.md 的“Choosing between them”。

共享 widget 应放在哪里 当同一 widget 被多个功能需要时,按顺序参照 presentation.md 的“Where the widget should live”:

  • 是否需要仓库或 domain 类型?若不需要,它就是纯展示组件,应放入 ui_kit。这是机械性判断而非风格判断:共享包只依赖外部包,需要仓库的 widget 无法在其中编译。
  • 若需要,就拆分:接收普通计数的 view 放入 ui_kit,Cubit 加该 view 留在其功能内、经自身 barrel 暴露。真正跨功能复用的 widget 通常是展示叶子,状态部分留在原处,说明需求本就指向 ui_kit。

当 Query 不够时:组合出功能 如果多领域逻辑长出自己的模型、界面或生命周期,就为它创建功能。参见 references/ffca/overview.md 的“Features”与“Presentation-only features”。把多个其他 domain 组合成一个界面而不持有业务逻辑的功能属于 presentation-only 功能:一个 {name}_presentation 包,没有 domain 或 data 兄弟包,依赖其他功能的 domain。

身份与实体 认证与用户资料是分离的 domain,而非一个。参见 faq.md 的“How do I handle auth and user profiles?”。AuthUser 放在 auth_domain,UserProfile 放在 user_profile_domain,在消费方 domain 中用 Query 粘合,这样新增资料字段不会迫使认证改动。

以上内容均来自资料原文,未提供的信息暂未提供。