packServer/backend/app/service/admin_member.js
liufumingren 3e2bd56416 feat(平台管理): 平台管理员与平台管理台(主体管理 / 订单管理 / 管理员)+ 顶栏下载入口
- 新表 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>
2026-10-29 17:21:16 +08:00

193 lines
6.9 KiB
JavaScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'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;