docs: annotate Foundry source and deployment lifecycle in Chinese [skip ci]
This commit is contained in:
@@ -1,3 +1,4 @@
|
||||
// 工作区与成员管理:所有成员/角色写入先锁工作区,使撤销和后续业务权限检查按同一顺序串行化。
|
||||
package platform
|
||||
|
||||
import (
|
||||
@@ -7,6 +8,7 @@ import (
|
||||
"strings"
|
||||
)
|
||||
|
||||
// workspaces 列出本人所属工作区,或在单个事务中创建工作区和所有者 admin 成员。
|
||||
func (s *service) workspaces(w http.ResponseWriter, r *http.Request, project, account string) error {
|
||||
switch r.Method {
|
||||
case http.MethodGet:
|
||||
@@ -73,6 +75,7 @@ WHERE m.project=$1 AND m.account_id=$2 ORDER BY lower(w.name),w.id LIMIT 200
|
||||
return nil
|
||||
}
|
||||
|
||||
// createWorkspace 同时供普通创建和 onboarding 使用;调用方负责提交,使所有者与成员记录原子落库。
|
||||
func createWorkspace(ctx context.Context, tx *sql.Tx, project, account, name string) (string, error) {
|
||||
var id string
|
||||
err := tx.QueryRowContext(ctx, `
|
||||
@@ -87,6 +90,7 @@ INSERT INTO workspace_members(project,workspace_id,account_id,role) VALUES($1,$2
|
||||
return id, err
|
||||
}
|
||||
|
||||
// lockWorkspace 先锁工作区再读调用者角色;等待并发撤销完成后读取,避免沿用旧成员权限。
|
||||
func lockWorkspace(ctx context.Context, tx *sql.Tx, project, workspace, account string) (string, string, error) {
|
||||
var owner, role string
|
||||
err := tx.QueryRowContext(ctx, `
|
||||
@@ -102,6 +106,7 @@ SELECT role FROM workspace_members WHERE project=$1 AND workspace_id=$2 AND acco
|
||||
return owner, role, err
|
||||
}
|
||||
|
||||
// workspace 允许成员读取,admin 改名/slug,仅 owner 能删除;读取分支结束由 defer 回滚释放锁。
|
||||
func (s *service) workspace(w http.ResponseWriter, r *http.Request, project, account string) error {
|
||||
workspace := r.PathValue("workspace")
|
||||
tx, err := s.db.BeginTx(r.Context(), nil)
|
||||
@@ -159,6 +164,7 @@ func (s *service) workspace(w http.ResponseWriter, r *http.Request, project, acc
|
||||
return nil
|
||||
}
|
||||
|
||||
// members 仅在调用方也是成员时返回列表;空结果按不可见资源处理,不披露工作区存在性。
|
||||
func (s *service) members(w http.ResponseWriter, r *http.Request, project, account string) error {
|
||||
if r.Method != http.MethodGet {
|
||||
reject(w, 405, "method_not_allowed")
|
||||
@@ -194,6 +200,7 @@ ORDER BY m.joined_at,m.account_id LIMIT 200
|
||||
return nil
|
||||
}
|
||||
|
||||
// member 管理单个成员:owner 身份不可降级/删除;普通成员只能删除自己,admin 可管理他人。
|
||||
func (s *service) member(w http.ResponseWriter, r *http.Request, project, account string) error {
|
||||
workspace, target := r.PathValue("workspace"), r.PathValue("account")
|
||||
if r.Method != http.MethodPatch && r.Method != http.MethodDelete {
|
||||
@@ -209,6 +216,7 @@ func (s *service) member(w http.ResponseWriter, r *http.Request, project, accoun
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
// owner 必须始终留在成员表,不能通过退出或修改角色破坏工作区管理入口。
|
||||
if owner == target {
|
||||
reject(w, 409, "owner_membership_required")
|
||||
return nil
|
||||
|
||||
Reference in New Issue
Block a user