- 新表 admin_members(user_id 唯一、name、role、status、remark,软删):平台级管理员, 与「主体管理员」完全分开;迁移会把内置管理员(username=admin,没有则 id=1)先入表 - 鉴权:middleware/platform_admin.js —— admin_members 启用行 **或** INTERNAL_ADMIN_IDS(内置/救急入口), 其余一律 403 not_platform_admin;接口挂在 /api/web/admin/* - 主体管理:GET 所有主体(成员数/管理员/是否过期)+ PUT 改授权到期时间 (直接设 expireAt 或 extendDays 顺延),改完失效 subjectState 缓存,设备心跳立刻生效 - 订单管理:GET 所有订单(主体名/下单人/续期前后)+ POST 确认订单 —— 复用支付回调的 payNotify()(标记已支付 + 主体顺延 + 失效缓存 + 幂等),渠道记 manual - 管理员:GET/POST/DELETE /api/web/admin/members(按账号加人、不能删自己/最后一个); 软删行仍占唯一键,查重带 paranoid:false + restore 复用 - 前端:左侧菜单新增「平台管理」组(只有平台管理员可见,路由 meta.platformAdmin 守卫、 不需要选主体),新增 AdminSubjectsView / AdminOrdersView / AdminMembersView - 顶栏右侧新增「下载桌面端 / 下载 Android 扫码台」两个按钮(与权限无关,所有人都显示), 版本号读 /download/version.json 与 /download/android_client/version.json,未发布则置灰提示 - 测试:admin.test.js 12 例(403/表内/内置/列表/添加/重复/删自己/主体列表/改期限/顺延/订单/确认幂等) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
193 lines
6.9 KiB
JavaScript
193 lines
6.9 KiB
JavaScript
'use strict';
|
||
|
||
const { Service } = require('egg');
|
||
const { Op } = require('sequelize');
|
||
|
||
const ROLE_TEXT = { 1: '超级管理员', 2: '管理员' };
|
||
const USER_ATTRIBUTES = [ 'id', 'username', 'nickname', 'email', 'phone', 'avatar', 'status' ];
|
||
|
||
/**
|
||
* 平台管理员(`admin_members`)
|
||
*
|
||
* 平台管理员 = 能看所有主体 / 所有订单、改授权到期时间、确认订单、加别的平台管理员的人。
|
||
* 与「主体管理员」(`subject_members.role=1`) 完全分开:后者只管自己那个主体。
|
||
*
|
||
* 谁能算平台管理员(满足其一):
|
||
* 1. `admin_members` 里 `status=1` 的行;
|
||
* 2. `config.internal.adminIds`(env `INTERNAL_ADMIN_IDS`,默认 `[1]`)里的账号 ——
|
||
* **内置/救急入口**:就算把最后一个管理员在页面上删了,也还能靠它进来加回来。
|
||
*/
|
||
class AdminMemberService extends Service {
|
||
get AdminMember() {
|
||
return this.app.model.AdminMember;
|
||
}
|
||
|
||
get User() {
|
||
return this.app.model.User;
|
||
}
|
||
|
||
/** 配置里的内置管理员 id 列表 */
|
||
get bootstrapIds() {
|
||
const cfg = this.app.config.internal || {};
|
||
return Array.isArray(cfg.adminIds) ? cfg.adminIds.map(Number) : [];
|
||
}
|
||
|
||
/** 这个账号是不是平台管理员(查库 + 内置名单) */
|
||
async isAdmin(userId) {
|
||
const id = Number(userId);
|
||
if (!Number.isInteger(id) || id <= 0) return false;
|
||
|
||
const row = await this.AdminMember.findOne({ where: { userId: id, status: 1 } });
|
||
if (row) return true;
|
||
return this.bootstrapIds.includes(id);
|
||
}
|
||
|
||
/** 内置名单里的账号(前端提示「内置管理员」用) */
|
||
isBootstrap(userId) {
|
||
return this.bootstrapIds.includes(Number(userId));
|
||
}
|
||
|
||
/**
|
||
* 平台管理员列表(含账号信息)
|
||
* @return {Promise<Array<object>>}
|
||
*/
|
||
async list() {
|
||
const rows = await this.AdminMember.findAll({ order: [[ 'role', 'ASC' ], [ 'id', 'ASC' ]] });
|
||
const userIds = rows.map(row => Number(row.userId));
|
||
// 内置名单里的人如果表里没有,也要露出来(否则页面上看不到「自己为什么是管理员」)
|
||
for (const id of this.bootstrapIds) {
|
||
if (!userIds.includes(id)) userIds.push(id);
|
||
}
|
||
|
||
const users = userIds.length
|
||
? await this.User.findAll({
|
||
where: { id: { [Op.in]: userIds } },
|
||
attributes: USER_ATTRIBUTES,
|
||
paranoid: false, // 账号被删了也要能看出来
|
||
})
|
||
: [];
|
||
const userMap = new Map(users.map(user => [ Number(user.id), user.toJSON() ]));
|
||
|
||
const list = rows.map(row => this.present(row, userMap.get(Number(row.userId))));
|
||
|
||
// 只在 bootstrap 名单里、表里没有的:补成「内置管理员」
|
||
for (const id of this.bootstrapIds) {
|
||
if (rows.some(row => Number(row.userId) === id)) continue;
|
||
list.push({
|
||
id: null,
|
||
userId: id,
|
||
name: this.nameOf(userMap.get(id)),
|
||
role: 1,
|
||
roleText: ROLE_TEXT[1],
|
||
status: 1,
|
||
remark: '内置管理员(INTERNAL_ADMIN_IDS)',
|
||
builtin: true,
|
||
user: userMap.get(id) || null,
|
||
createdAt: null,
|
||
});
|
||
}
|
||
|
||
return list;
|
||
}
|
||
|
||
/**
|
||
* 添加平台管理员(按账号找用户)
|
||
*
|
||
* 账号可以是用户名 / 手机号 / 邮箱(与登录一致)。已经在名单里的:
|
||
* - 启用中 → 409;
|
||
* - 停用/软删 → 恢复并更新角色(避免撞唯一索引,也方便「加回来」)。
|
||
*
|
||
* @param {object} params { account, name, role, remark }
|
||
*/
|
||
async add({ account, name, role, remark } = {}) {
|
||
const key = String(account || '').trim();
|
||
if (!key) this.ctx.throw(422, '请填写账号(用户名 / 手机号 / 邮箱)');
|
||
if (key.length > 128) this.ctx.throw(422, '账号过长');
|
||
|
||
const user = await this.User.findOne({
|
||
where: { [Op.or]: [ { username: key }, { phone: key }, { email: key.toLowerCase() } ] },
|
||
attributes: USER_ATTRIBUTES,
|
||
paranoid: false,
|
||
});
|
||
if (!user) this.ctx.throw(404, '账号不存在,请先在「个人中心」注册,或用运维脚本建号');
|
||
if (Number(user.status) !== 1 || user.deletedAt) this.ctx.throw(409, '该账号已被禁用或删除,不能设为管理员');
|
||
|
||
const finalRole = Number(role) === 2 ? 2 : 1;
|
||
// ⚠️ 必须带 paranoid:false:软删的行仍占着 user_id 唯一索引,查不到就会撞唯一键(报 Validation error)
|
||
const existing = await this.AdminMember.findOne({ where: { userId: Number(user.id) }, paranoid: false });
|
||
|
||
if (existing && !existing.deletedAt && Number(existing.status) === 1) {
|
||
this.ctx.throw(409, `${this.nameOf(user)} 已经是平台管理员了`);
|
||
}
|
||
|
||
const payload = {
|
||
userId: Number(user.id),
|
||
name: String(name || '').trim().slice(0, 32) || this.nameOf(user),
|
||
role: finalRole,
|
||
status: 1,
|
||
remark: remark === undefined ? existing && existing.remark : remark,
|
||
};
|
||
|
||
let row;
|
||
if (existing) {
|
||
if (existing.deletedAt) await existing.restore();
|
||
await existing.update(payload);
|
||
row = existing;
|
||
} else {
|
||
row = await this.AdminMember.create(payload);
|
||
}
|
||
|
||
this.ctx.logger.info('[admin] 添加平台管理员:userId=%s(%s,role=%s)', user.id, payload.name, finalRole);
|
||
return this.present(row, user.toJSON());
|
||
}
|
||
|
||
/**
|
||
* 移除平台管理员(软删)
|
||
*
|
||
* 两条保护:不能移除自己(避免当场把自己锁在外面)、不能移除最后一个启用的管理员。
|
||
*/
|
||
async remove({ id, operatorUserId } = {}) {
|
||
const rowId = Number(id);
|
||
if (!Number.isInteger(rowId) || rowId <= 0) this.ctx.throw(400, 'id 必须是正整数');
|
||
|
||
const row = await this.AdminMember.findByPk(rowId);
|
||
if (!row) this.ctx.throw(404, '管理员不存在');
|
||
|
||
if (Number(row.userId) === Number(operatorUserId)) this.ctx.throw(409, '不能移除自己');
|
||
|
||
const enabled = await this.AdminMember.count({ where: { status: 1 } });
|
||
if (Number(row.status) === 1 && enabled <= 1 && !this.bootstrapIds.length) {
|
||
this.ctx.throw(409, '至少要保留一个平台管理员');
|
||
}
|
||
|
||
await row.destroy();
|
||
this.ctx.logger.info('[admin] 移除平台管理员:id=%s userId=%s(操作人 %s)', row.id, row.userId, operatorUserId);
|
||
return { id: rowId, userId: Number(row.userId) };
|
||
}
|
||
|
||
/** 展示字段(固定 camelCase) */
|
||
present(row, user) {
|
||
const role = Number(row.role) || 1;
|
||
return {
|
||
id: Number(row.id),
|
||
userId: Number(row.userId),
|
||
name: row.name || this.nameOf(user),
|
||
role,
|
||
roleText: ROLE_TEXT[role] || '管理员',
|
||
status: Number(row.status),
|
||
remark: row.remark || null,
|
||
builtin: this.isBootstrap(row.userId),
|
||
user: user || null,
|
||
createdAt: row.createdAt || row.created_at || null,
|
||
};
|
||
}
|
||
|
||
/** 账号的显示名:备注名 → 昵称 → 用户名 → #id */
|
||
nameOf(user) {
|
||
if (!user) return '未知账号';
|
||
return String(user.nickname || user.username || `#${user.id}`);
|
||
}
|
||
}
|
||
|
||
module.exports = AdminMemberService;
|