forked from bai/curriculum-project-hub
feat(admin): gate project surfaces behind permission grants for members
The org admin SPA was org-admin only: every project route used requireOrgRole, so a plain MEMBER could not reach the projects they held a project grant on, and an org OWNER/ADMIN could mutate any project without holding the project's `manage` grant. That contradicts ADR-0004 (spec `Permission.lean`): org role is not a project authorization root, and the only out-of-role override is platform-admin force-release (`RequiresAdmin`), not org admin. Add `requireProjectPermission` (guards.ts): resolve any org member, bind the project to their org, then check the PermissionGrant authorizer. `allowOrgAdminOversight=true` lets OWNER/ADMIN through for *read* oversight only; mutations pinned to `collaborator.manage` (grant/revoke team-access) pass `allowOrgAdminOversight=false`, so an org admin still needs the project MANAGE grant to mutate access. The project detail GET now also returns `actorIsOrgAdmin` and `actorCanManageProject` so the SPA can render mutation controls only for entitled actors. Add a member-facing project surface: - `GET /api/org/:orgSlug/my-projects` + `listMyProjects` resolve the actor's principals and return the projects with a READ+ grant. - The SPA routes members (non-admin) to the projects page instead of the admin overview, renders a member project shell on project routes, shows a `我的项目` list for members and the full folder explorer for admins. - The project detail page gates rename/archive/bind/sessions behind org admin and the grant/revoke UI behind `actorCanManageProject`. - The denied panel now points members at their authorized projects. Update admin-members-teams integration test: seed the owner with a MANAGE grant on the test project so the org-owner flow still passes the new project-level gate on team-access grant/revoke.
This commit is contained in:
@@ -10,8 +10,10 @@ import {
|
||||
verifySession,
|
||||
type SessionPayload,
|
||||
} from "./session.js";
|
||||
import { createPermissionAuthorizer, type AuthorizationAction } from "../../permissions/authorizer.js";
|
||||
|
||||
export const ORG_ADMIN_ROLES: readonly OrganizationMemberRole[] = ["OWNER", "ADMIN"];
|
||||
const ANY_ORG_ROLE: readonly OrganizationMemberRole[] = ["OWNER", "ADMIN", "MEMBER"];
|
||||
|
||||
export interface AuthContext {
|
||||
readonly session: SessionPayload;
|
||||
@@ -175,3 +177,55 @@ export async function sendError(
|
||||
): Promise<void> {
|
||||
await reply.status(statusCode).send({ error: { code, message } });
|
||||
}
|
||||
|
||||
export interface ProjectAuthContext extends OrgAuthContext {
|
||||
readonly projectId: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Resolve an org member (any role) viewing/mutating a project in their org, then
|
||||
* enforce project-level permission via the PermissionGrant authorizer.
|
||||
*
|
||||
* `allowOrgAdminOversight=true` lets org OWNER/ADMIN through without a project
|
||||
* grant — reserved for *read* oversight (listing/viewing). Mutations that the
|
||||
* spec pins to project `manage` (e.g. `collaborator.manage`) must pass
|
||||
* `allowOrgAdminOversight=false`: org role alone is not a project authorization
|
||||
* root (spec `Permission.lean` / ADR-0004; the only out-of-role override is
|
||||
* platform-admin force-release `RequiresAdmin`, not org admin).
|
||||
*/
|
||||
export async function requireProjectPermission(
|
||||
request: FastifyRequest,
|
||||
reply: FastifyReply,
|
||||
deps: GuardDeps,
|
||||
options: {
|
||||
readonly orgSlug: string;
|
||||
readonly projectId: string;
|
||||
readonly action: AuthorizationAction;
|
||||
readonly allowOrgAdminOversight: boolean;
|
||||
},
|
||||
): Promise<ProjectAuthContext | null> {
|
||||
const auth = await requireOrgRole(request, reply, deps, {
|
||||
orgSlug: options.orgSlug,
|
||||
roles: ANY_ORG_ROLE,
|
||||
});
|
||||
if (auth === null) return null;
|
||||
await requireOrgProject(deps, auth.organization.id, options.projectId);
|
||||
if (options.allowOrgAdminOversight && ORG_ADMIN_ROLES.includes(auth.membershipRole)) {
|
||||
return { ...auth, projectId: options.projectId };
|
||||
}
|
||||
const decision = await createPermissionAuthorizer(deps.prisma).can({
|
||||
actor: { feishuOpenId: auth.feishuOpenId },
|
||||
action: options.action,
|
||||
resource: { type: "PROJECT", id: options.projectId },
|
||||
});
|
||||
if (!decision.allowed) {
|
||||
await sendError(
|
||||
reply,
|
||||
403,
|
||||
"forbidden",
|
||||
`project ${options.projectId} requires ${decision.requiredRole} (${options.action}): ${decision.reason}`,
|
||||
);
|
||||
return null;
|
||||
}
|
||||
return { ...auth, projectId: options.projectId };
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user