SuperAPI AI 工具集

content-relationships

通用与其它

查看项目

更新于 10-16 05:39

技能介绍

Content Relationships 是一项用于指导在无头 CMS 架构中设计和实现内容项之间关系的技能。

【用途】 该技能适用于以下场景:为内容类型添加内容选择器(content picker)字段;设计作者与文章之间的关系;实现相关内容功能;构建内容层级(父/子页面);管理双向关系;在删除时处理引用完整性。相关技能为 content-type-modeling(定义关系字段)、dynamic-schema-design(在 JSON 中存储引用)、headless-api-design(关系 API 端点)。

【关系类型】 技能列出多种关系类型并给出 C# 示例代码:

  1. 一对多(父引用):例如文章有一个作者,文章持有 AuthorId 外键与 Author 导航属性,作者持有 Articles 反向导航属性。
  2. 多对多(中间表):例如文章有多个分类、分类有多个文章,通过 ArticleCategory 中间表实现,可包含关系元数据(如 Order、IsPrimary),并给出 EF Core 配置 HasKey。
  3. 自引用(层级):例如页面层级,Page 持有 ParentId、Parent 导航属性与 Children 集合,并包含用于高效查询的 Path 与 Depth 计算字段。
  4. 多态引用(任意内容类型):ContentReference 记录引用项与被引用项的 Id 与类型,以及 RelationshipType(如 "related"、"featured"、"see-also")与 Order。

【内容选择器字段模式】 给出通用 ContentPickerField 结构,包含 AllowedContentTypes、ContentItemIds、MinItems、MaxItems、ShowContentType 与 DisplayTemplate,示例存储于 JSON 列。另给出用于 API 的已解析引用结构 ContentPickerFieldDto 与 ContentItemSummary(含 Id、ContentType、DisplayText、Url、ThumbnailUrl)。

【关系加载策略】

  1. 预加载(Eager Loading):使用 Include 与 ThenInclude 在初始查询中加载关系。
  2. 显式加载(Explicit Loading):通过 Entry(...).Reference/Collection 按需加载。
  3. 面向 API 的投影(Projection):使用 Select 仅加载响应所需字段。

【双向关系】 给出 RelatedContent 结构(SourceId、TargetId、RelationType、IsBidirectional)与 ContentRelationshipService 示例,AddRelationshipAsync 在前向关系外可选添加反向关系,GetReverseType 映射关系方向(如 parent-of 对应 child-of,references 对应 referenced-by,对称关系如 related-to 保持不变)。

【引用完整性】

  1. 删除行为:ReferenceDeleteBehavior 枚举包括 Restrict(被引用时阻止删除)、Cascade(删除引用项)、SetNull(清空引用)、NoAction(保留孤儿,由应用处理),并给出 EF Core OnDelete 配置示例。
  2. 孤儿检测:OrphanDetectionService 提供 FindOrphanReferencesAsync(查找目标已不存在的引用)与 FindUnreferencedContentAsync(查找未被任何内容引用的内容)。

【关系 API 设计】

  1. REST 模式:支持 include 查询参数(如 GET /api/articles/{id}?include=author,categories)、嵌套资源(如 /api/articles/{id}/author、/api/authors/{id}/articles)以及关系管理端点(POST/DELETE/PUT 用于 categories 与 author)。示例响应采用 data/relationships/included 结构。
  2. GraphQL:示例定义了 Article 类型(含 author、categories、relatedArticles(first: Int))以及查询入口与反向查询(articlesByAuthor、articlesByCategory)。

【限制】 资料未提供该技能的收费、价格、平台支持范围或具体安装步骤,暂未提供。