docs: update env workflow and role_code contracts

2026-04-03 15:50:19 +08:00
parent 01a4580faf
commit cd7feec38a
6 changed files with 10 additions and 5 deletions
--- a/docs/INTERNAL_API_HANDOFF.md
+++ b/docs/INTERNAL_API_HANDOFF.md
@@ -36,6 +36,7 @@
      "system_key": "SY20260402X0001",
      "system_name": "Marketing",
      "role_key": "RL20260402X0002",
+      "role_code": "mkt:marketing_card:edit",
      "role_name": "campaign_edit"
    }
  ]
@@ -45,3 +46,4 @@
 ## 注意事項
 - 不提供 user direct role 寫入 API。
 - User 最終角色由 `user_sites` + `site_roles` 推導。
+- `role_key` 是唯一識別鍵；業務語意解析請使用 `role_code`。