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

49 lines
1.6 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 { Controller } = require('egg');
/** 路径参数转正整数,非法返回 null */
function toId(value) {
const id = Number(value);
return Number.isInteger(id) && id > 0 ? id : null;
}
/**
* web 平台管理员:**所有主体**(`/api/web/admin/subjects`)
*
* 鉴权:`middleware.apiAuth()` + `middleware.platformAdmin()`。
*
* - `GET /api/web/admin/subjects?page=&pageSize=&keyword=&status=&expired=`
* 所有主体(带成员数 / 管理员账号 / 是否过期),keyword 模糊匹配主体名或备注
* - `PUT /api/web/admin/subjects/:id`
* 改授权到期时间:`{ expireAt: '2027-01-01 00:00:00' }` 直接设,
* 或 `{ extendDays: 30 }` 顺延;也可顺带改 `remark` / `status`
*/
class WebAdminSubjectController extends Controller {
/** GET /api/web/admin/subjects */
async index() {
const { ctx } = this;
const data = await ctx.service.subject.listAll({
page: ctx.query.page,
pageSize: ctx.query.pageSize,
keyword: ctx.query.keyword,
status: ctx.query.status,
expired: ctx.query.expired,
});
ctx.body = { ok: true, data };
}
/** PUT /api/web/admin/subjects/:id */
async update() {
const { ctx } = this;
const id = toId(ctx.params.id);
if (!id) ctx.throw(400, 'id 必须是正整数');
const { expireAt, extendDays, remark, status } = ctx.request.body || {};
const data = await ctx.service.subject.setExpireAt(id, { expireAt, extendDays, remark, status }, ctx.state.user.id);
ctx.body = { ok: true, data };
}
}
module.exports = WebAdminSubjectController;