feat(database): 后台成员组(MemberGroup)管理与嵌套解析

hub/src/database/filelib/groupResolver.ts

@@ -2,8 +2,10 @@
  * GroupResolver port(契约 C2)。
  *
  * 权限计算只依赖这一个查询:"用户 → 所属 Group(含全部祖先)"。
- * Group 系统(需求系统二:全局、无限嵌套)由别的团队交付;调用方只依赖此
- * port,真身到位后替换实现,不换调用点。
+ * ADR-0028 起,默认实现是 in-hub 的 MemberGroup 闭包读取器
+ * (`createMemberGroupResolver`,见 memberGroupResolver.ts);
+ * `HUB_GROUP_SERVICE_URL` 配置后切外部 HTTP 实现(groupResolverHttp.ts)。
+ * 调用方只依赖此 port,不换调用点。
  */
 
 import type { PrismaClient } from "@prisma/client";
@@ -13,9 +15,11 @@ export interface GroupResolver {
 }
 
 /**
- * 过渡实现:读 hub 既有 Team(org 内、扁平无嵌套 → "祖先即自身")。
- * 需求 3.2 的祖先递归语义在嵌套 Group 落地前无从谈起;此实现保证权限引擎
- * 的 Group 通路今天就是真的,而不是 mock。
+ * @deprecated ADR-0028:成员组已内置为 in-hub MemberGroup,默认 resolver 改为
+ * `createMemberGroupResolver`。此扁平 Team 过渡实现不再接线,保留仅为历史参照
+ * (以及潜在的迁移对照),新代码不要使用。
+ *
+ * 旧过渡实现:读 hub 既有 Team(org 内、扁平无嵌套 → "祖先即自身")。
  */
 export function createTeamGroupResolver(
   prisma: PrismaClient,