后端 - 数据库层面本来就允许多管理员(subject_members 只有 subject_id+user_id 唯一索引,role 无唯一约束), 新增 PUT /api/web/subjects/:id/members/:memberId/role(role=1 管理员 / 2 成员) - 服务层 setMemberRole:创建者不能降级、不能改自己的角色、role 只接受 1/2;返回带 isCreator - 成员管理收口到管理员:addMember / removeMember / createBindCode 由 findForUser 改为 ensureAdmin (此前任何成员都能增删成员,属于越权) - removeMember 增加「管理员需先取消管理员身份再移除」;members() 返回 isCreator 前端 - 成员管理弹窗:「设为管理员 / 取消管理员」按钮,仅管理员可见;创建者行标「创建者」、自己行标「(你自己)」 并隐藏不可操作的按钮;非管理员进入弹窗只看到只读列表 + 提示文案 - subjectApi 增加 updateSubjectMemberRole,SubjectItem.memberId / SubjectMemberItem.isCreator 类型补齐 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
156 lines
5.1 KiB
JavaScript
156 lines
5.1 KiB
JavaScript
'use strict';
|
||
|
||
const { Controller } = require('egg');
|
||
|
||
/** 路径参数转正整数,非法返回 null */
|
||
function toId(value) {
|
||
const id = Number(value);
|
||
return Number.isInteger(id) && id > 0 ? id : null;
|
||
}
|
||
|
||
/**
|
||
* web 主体端:主体与成员管理(`/api/web/subjects`)
|
||
*
|
||
* 鉴权:`middleware.apiAuth()`(只认 header 令牌)。
|
||
* **这些接口不需要 `X-Subject-Id`**:主体 id 在路径里,服务层再校验「当前用户是不是这个主体的成员」。
|
||
*
|
||
* 关键规则:
|
||
* - 创建主体:管理员 = 创建人,使用期限默认赠送 7 天(`config.subject.trialDays`)
|
||
* - 主体列表:只返回「我是成员」的主体(含角色、成员数、是否过期)
|
||
* - 成员:可按姓名快速创建(尚未绑定账号),再用「绑定码」扫码绑定
|
||
* - **成员管理(增 / 删 / 发绑定码 / 改角色)只有主体管理员能做**,普通成员只能看列表;
|
||
* 一个主体可以有多个管理员(`subject_members.role=1`),创建者恒为管理员且不能降级
|
||
*/
|
||
class WebSubjectController extends Controller {
|
||
/** GET /api/web/subjects —— 我可进入的主体列表 */
|
||
async index() {
|
||
const { ctx } = this;
|
||
const list = await ctx.service.subject.listForUser(ctx.state.user.id);
|
||
ctx.body = { ok: true, data: { list, trialDays: ctx.service.subject.trialDays } };
|
||
}
|
||
|
||
/** POST /api/web/subjects —— { name, days?, remark? } */
|
||
async create() {
|
||
const { ctx } = this;
|
||
const { name, days, remark } = ctx.request.body || {};
|
||
|
||
const data = await ctx.service.subject.create({
|
||
userId: ctx.state.user.id,
|
||
name,
|
||
days,
|
||
remark,
|
||
});
|
||
|
||
ctx.status = 201;
|
||
ctx.body = { ok: true, data };
|
||
}
|
||
|
||
/** GET /api/web/subjects/:id —— 主体详情(含我的角色) */
|
||
async show() {
|
||
const { ctx } = this;
|
||
const id = toId(ctx.params.id);
|
||
if (!id) ctx.throw(400, 'id 必须是正整数');
|
||
|
||
const { subject, member } = await ctx.service.subject.findForUser(id, ctx.state.user.id);
|
||
const memberCount = await ctx.service.subject
|
||
.listForUser(ctx.state.user.id)
|
||
.then(list => (list.find(item => Number(item.id) === id) || {}).memberCount || 0);
|
||
|
||
ctx.body = {
|
||
ok: true,
|
||
data: Object.assign(ctx.service.subject.present(subject), {
|
||
role: Number(member.role),
|
||
memberName: member.name,
|
||
memberCount,
|
||
}),
|
||
};
|
||
}
|
||
|
||
/** PUT /api/web/subjects/:id —— { name?, remark?, extendDays? }(仅管理员) */
|
||
async update() {
|
||
const { ctx } = this;
|
||
const id = toId(ctx.params.id);
|
||
if (!id) ctx.throw(400, 'id 必须是正整数');
|
||
|
||
const { name, remark, extendDays } = ctx.request.body || {};
|
||
const data = await ctx.service.subject.update(id, ctx.state.user.id, { name, remark, extendDays });
|
||
ctx.body = { ok: true, data };
|
||
}
|
||
|
||
/** GET /api/web/subjects/:id/members —— 成员列表 */
|
||
async members() {
|
||
const { ctx } = this;
|
||
const id = toId(ctx.params.id);
|
||
if (!id) ctx.throw(400, 'id 必须是正整数');
|
||
|
||
const list = await ctx.service.subject.members(id, ctx.state.user.id);
|
||
ctx.body = { ok: true, data: { subjectId: id, list } };
|
||
}
|
||
|
||
/** POST /api/web/subjects/:id/members —— { name } 按姓名快速添加成员(仅管理员) */
|
||
async addMember() {
|
||
const { ctx } = this;
|
||
const id = toId(ctx.params.id);
|
||
if (!id) ctx.throw(400, 'id 必须是正整数');
|
||
|
||
const { name, role } = ctx.request.body || {};
|
||
const data = await ctx.service.subject.addMember({
|
||
subjectId: id,
|
||
userId: ctx.state.user.id,
|
||
name,
|
||
role,
|
||
});
|
||
ctx.status = 201;
|
||
ctx.body = { ok: true, data };
|
||
}
|
||
|
||
/** PUT /api/web/subjects/:id/members/:memberId/role —— { role: 1|2 } 设为管理员 / 取消管理员(仅管理员) */
|
||
async updateMemberRole() {
|
||
const { ctx } = this;
|
||
const id = toId(ctx.params.id);
|
||
const memberId = toId(ctx.params.memberId);
|
||
if (!id || !memberId) ctx.throw(400, 'id 必须是正整数');
|
||
|
||
const { role } = ctx.request.body || {};
|
||
const data = await ctx.service.subject.setMemberRole({
|
||
subjectId: id,
|
||
operatorUserId: ctx.state.user.id,
|
||
memberId,
|
||
role,
|
||
});
|
||
ctx.body = { ok: true, data };
|
||
}
|
||
|
||
/** DELETE /api/web/subjects/:id/members/:memberId */
|
||
async removeMember() {
|
||
const { ctx } = this;
|
||
const id = toId(ctx.params.id);
|
||
const memberId = toId(ctx.params.memberId);
|
||
if (!id || !memberId) ctx.throw(400, 'id 必须是正整数');
|
||
|
||
const data = await ctx.service.subject.removeMember({
|
||
subjectId: id,
|
||
operatorUserId: ctx.state.user.id,
|
||
memberId,
|
||
});
|
||
ctx.body = { ok: true, data };
|
||
}
|
||
|
||
/** POST /api/web/subjects/:id/members/:memberId/bind-code —— 生成成员绑定码 */
|
||
async memberBindCode() {
|
||
const { ctx } = this;
|
||
const id = toId(ctx.params.id);
|
||
const memberId = toId(ctx.params.memberId);
|
||
if (!id || !memberId) ctx.throw(400, 'id 必须是正整数');
|
||
|
||
const data = await ctx.service.subject.createBindCode({
|
||
subjectId: id,
|
||
memberId,
|
||
operatorUserId: ctx.state.user.id,
|
||
});
|
||
ctx.body = { ok: true, data };
|
||
}
|
||
}
|
||
|
||
module.exports = WebSubjectController;
|