Просмотр исходного кода

💡 (api-v13): FIXME:团队成员与团队文档的 URL 用了雪花 id

groups/{group}/members/{member} 应改成 /members/{user_id},
groups/{group}/shares/{share} 应改成 /shares/{res_id}。现在不改,先记下改法。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
visuddhinanda 5 часов назад
Родитель
Сommit
a9582cd6ad

+ 4 - 0
api-v13/app/Http/Controllers/V3/GroupMemberController.php

@@ -85,6 +85,8 @@ class GroupMemberController extends Controller
      */
     public function update(UpdateGroupMemberRequest $request, GroupInfo $group, GroupMember $member)
     {
+        // FIXME: {member} 是 group_members.id(雪花 id),应改成用户 uuid:一个用户在一个团队里只有一行
+        //   (唯一索引 user_id + group_id),路由改为 groups/{group}/members/{user_id}。见 routes/v3/group.php。
         return GroupMemberResource::make($this->members->update(
             $group,
             $member,
@@ -107,6 +109,8 @@ class GroupMemberController extends Controller
      */
     public function destroy(Request $request, GroupInfo $group, GroupMember $member)
     {
+        // FIXME: {member} 是 group_members.id(雪花 id),应改成用户 uuid:一个用户在一个团队里只有一行
+        //   (唯一索引 user_id + group_id),路由改为 groups/{group}/members/{user_id}。见 routes/v3/group.php。
         $this->members->remove($group, $member, $this->currentUser($request)['user_uid']);
 
         return response()->noContent();

+ 3 - 0
api-v13/app/Http/Controllers/V3/GroupShareController.php

@@ -58,6 +58,9 @@ class GroupShareController extends Controller
      */
     public function destroy(Request $request, GroupInfo $group, Share $share)
     {
+        // FIXME: {share} 是 shares.id(雪花 id),应改成被共享资源的 uuid:一项资源在一个团队下只共享一次
+        //   (唯一索引 res_id + res_type + cooperator_id + cooperator_type),路由改为 groups/{group}/shares/{res_id}。
+        //   见 routes/v3/group.php。
         $this->shares->remove($group, $share, $this->currentUser($request)['user_uid']);
 
         return response()->noContent();

+ 9 - 0
api-v13/routes/v3/group.php

@@ -30,6 +30,10 @@ Route::patch('groups/{group}', [GroupController::class, 'update'])
     ->whereUuid('group');
 
 // 团队成员。scopeBindings:{member} 必须属于 {group},否则 404。
+// FIXME: {member} 现在是 group_members.id(雪花 id,内部主键不该进 URL)。一个用户在一个团队里只会有一行
+//   (库里有唯一索引 group_members_user_id_group_id_unique),应改成 groups/{group}/members/{user_id}(用户 uuid),
+//   按 (group_id, user_id) 定位;同时去掉 me/groups 的 member_id、成员行的 id 改成用户 uuid,
+//   v6 的 src/api/group-member.ts 与 features/teamspace/refreshMyGroups.ts 跟着改。现在不改(2026-11-17 用户定)。
 // 用组而不是 apiResource()->scoped():后者会把 URI 写成 {group:},规格生成器认不出。
 // 只注册 PATCH,不注册 PUT(v3-resource skill 硬规范第 10 条)
 Route::middleware('auth.v3')->scopeBindings()->group(function () {
@@ -43,6 +47,11 @@ Route::middleware('auth.v3')->scopeBindings()->group(function () {
         ->whereNumber('member');
 
     // 团队文档(共享给团队的资源)。{share} 必须是共享给 {group} 的
+    // FIXME: {share} 现在是 shares.id(雪花 id,内部主键不该进 URL)。在一个团队下,一项资源只会共享一次
+    //   (库里有唯一索引 shares_res_id_res_type_cooperator_id_cooperator_type_unique,cooperator 就是团队),
+    //   应改成 groups/{group}/shares/{res_id}(被共享资源的 uuid),按 (cooperator_id = group, res_id) 定位;
+    //   资源 uuid 跨类型实际不会重复,真要严格就再加 ?res_type=。列表行的 id 跟着改成资源 uuid,
+    //   v6 的移出团队调用一并改。现在不改(2026-11-17 用户定)。
     Route::apiResource('groups.shares', GroupShareController::class)
         ->only(['index', 'destroy'])
         ->whereUuid('group')