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

50 lines
1.7 KiB
JavaScript
Raw 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');
/**
* web 平台管理员:**所有订单**(`/api/web/admin/orders`)
*
* 鉴权:`middleware.apiAuth()` + `middleware.platformAdmin()`。
*
* - `GET /api/web/admin/orders?page=&pageSize=&keyword=&status=&subjectId=`
* 所有续期订单(带主体名 / 下单人),keyword 模糊匹配订单号 / 套餐名 / 主体名
* - `POST /api/web/admin/orders/:orderNo/confirm`
* **确认订单**:与支付渠道回调走**同一个** `service.subjectOrder.payNotify()`,
* 所以「标记已支付 + 主体顺延 + 失效状态缓存 + 幂等」这些后续动作完全一致,
* 只是渠道记成 `manual`、流水号记成 `ADMIN-<时间戳>`(便于和真实渠道对账区分)。
*/
class WebAdminOrderController extends Controller {
/** GET /api/web/admin/orders */
async index() {
const { ctx } = this;
const data = await ctx.service.subjectOrder.listAll({
page: ctx.query.page,
pageSize: ctx.query.pageSize,
keyword: ctx.query.keyword,
status: ctx.query.status,
subjectId: ctx.query.subjectId,
});
ctx.body = { ok: true, data };
}
/** POST /api/web/admin/orders/:orderNo/confirm */
async confirm() {
const { ctx } = this;
const orderNo = String(ctx.params.orderNo || '').trim();
if (!orderNo) ctx.throw(400, 'orderNo 不能为空');
const data = await ctx.service.subjectOrder.payNotify({
orderNo,
transactionId: `ADMIN-${Date.now()}`,
channel: 'manual',
});
ctx.logger.info('[admin] 平台管理员 %s 确认订单 %s(duplicated=%s)',
ctx.state.user.id, orderNo, data.duplicated);
ctx.body = { ok: true, data };
}
}
module.exports = WebAdminOrderController;