kate522andClaude Fable 5
e7ca0ee5df
users.php → 工单管理 的「配置」Tab 只管理部门 / 状态 / 预设回复三块 DB 字典，与 SPA「工单中心」已有的 8 个标量配置分裂成两处；且同一套 CRUD 在 admin_post 与 TicketConfigRest 里各写了一遍，REST 侧此前 没有任何调用方。 - 删除原生 config tab：UsersMenusTicketsConfig.php 整份移除， UsersMenusTicketsCenter 由 512 行降到 251 行（六个写处理方法、 分发分支、十条提示码与 ticket_delete_button 一并清理） - SPA /users/ticket 改为 customPage：内嵌 SchemaPage 承载原有 8 字段， 三块字典改为 n-data-table + n-modal + n-dialog，取色器/管理员多选/ 拖拽排序替代原生手填表单 - TicketConfigRest 成为三块字典的唯一实现，新增 api/modules/tickets.js 封装 aksrt/v1/admin/tickets* - 双向深链：原生页跳 SPA 配置页，SPA 页跳回原生工单列表 契约测试同步更新，并新增 ticket-spa-config-contract 守护接线。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
107 lines
4.8 KiB
JavaScript
107 lines
4.8 KiB
JavaScript
'use strict';
|
||
|
||
/**
|
||
* SPA「工单中心」接线契约：
|
||
* 1) /users/ticket 是 customPage，组件 UsersTicket 已注册并能被 router 解析；
|
||
* 2) 页面内嵌 SchemaPage 承载 users/ticket 分区，schema 表单零改动复用；
|
||
* 3) 三块字典 CRUD 走 TicketRestAdmin（aksrt/v1/admin）的封装模块；
|
||
* 4) 双向深链：SPA → 原生工单列表，原生 → SPA 工单中心；
|
||
* 5) 配置 Tab 的残留（tab=config / UsersMenusTicketsConfig）不得回流。
|
||
*/
|
||
|
||
const assert = require('node:assert/strict');
|
||
const fs = require('node:fs');
|
||
const path = require('node:path');
|
||
|
||
const test = require('node:test');
|
||
|
||
const root = path.resolve(__dirname, '../..');
|
||
const read = (file) => fs.readFileSync(path.join(root, file), 'utf8');
|
||
|
||
test('the ticket page is a custom page backed by UsersTicket', () => {
|
||
const loaders = read('assets/admin/src/router/component-loaders/users.js');
|
||
assert.ok(
|
||
loaders.includes("UsersTicket: () => import('@/pages/users/UsersTicket.vue')"),
|
||
'UsersTicket loader missing'
|
||
);
|
||
|
||
const constants = read('assets/admin/src/constants/sections/users.js');
|
||
// 入口必须是 customPage 且显式指定组件，否则 router 会回落到 SchemaPage。
|
||
assert.match(constants, /customPage\(\{[\s\S]*?component: 'UsersTicket'/);
|
||
assert.ok(constants.includes("key: 'users-ticket'"), 'menu page key missing');
|
||
assert.ok(constants.includes("route: '/users/ticket'"), 'menu route missing');
|
||
assert.ok(constants.includes("section: 'ticket'"), 'menu section missing');
|
||
assert.ok(constants.includes("canonicalDomain: 'users'"), 'menu canonical domain missing');
|
||
});
|
||
|
||
test('UsersTicket embeds the schema page and the three CRUD panels', () => {
|
||
const page = read('assets/admin/src/pages/users/UsersTicket.vue');
|
||
|
||
// 基础配置复用 SchemaPage，域/分区显式传入，避免依赖路由 meta。
|
||
assert.match(page, /<SchemaPage\s+domain="users"\s+section="ticket"/);
|
||
|
||
for (const panel of ['TicketTypePanel', 'TicketStatusPanel', 'TicketPrereplyPanel']) {
|
||
assert.ok(page.includes(panel), `panel ${panel} not mounted`);
|
||
assert.ok(
|
||
fs.existsSync(path.join(root, `assets/admin/src/pages/users/partials/ticket/${panel}.vue`)),
|
||
`panel ${panel} file missing`
|
||
);
|
||
}
|
||
|
||
// 反向深链：回到原生工单列表。
|
||
assert.match(page, /users\.php\?page=aksrt_tickets/);
|
||
assert.match(page, /window\.aksrtAdminData\?\.adminUrl/);
|
||
});
|
||
|
||
test('ticket admin REST is wrapped in its own api module and registered', () => {
|
||
const module = read('assets/admin/src/api/modules/tickets.js');
|
||
|
||
// TicketRestAdmin 挂在 aksrt/v1/admin，客户端 baseUrl 只到 aksrt/v1，
|
||
// 因此必须走 /aksrt/ 全路径形式。
|
||
assert.match(module, /'\/aksrt\/v1\/admin\/tickets'/);
|
||
|
||
for (const method of [
|
||
'listTicketStatuses', 'createTicketStatus', 'updateTicketStatus', 'deleteTicketStatus',
|
||
'listTicketTypes', 'createTicketType', 'updateTicketType', 'deleteTicketType',
|
||
'listTicketPrereplies', 'createTicketPrereply', 'updateTicketPrereply',
|
||
'deleteTicketPrereply', 'reorderTicketPrereplies',
|
||
]) {
|
||
assert.ok(module.includes(`${method}(`), `api method ${method} missing`);
|
||
}
|
||
|
||
const index = read('assets/admin/src/api/modules/index.js');
|
||
assert.ok(index.includes("import { ticketsApiMethods } from './tickets.js'"), 'module not imported');
|
||
assert.ok(index.includes('...ticketsApiMethods,'), 'module not spread into apiMethods');
|
||
});
|
||
|
||
test('panels enforce the backend guards instead of trusting the client', () => {
|
||
const status = read('assets/admin/src/pages/users/partials/ticket/TicketStatusPanel.vue');
|
||
|
||
// 默认状态的编辑/删除入口在前端禁用，但后端 TicketConfigRest 仍有 409 兜底。
|
||
assert.match(status, /disabled: row\.is_default/);
|
||
// 颜色必须落在 TicketStatusService::sanitize_color() 接受的范围内。
|
||
assert.match(status, /\^#\(\?:\[0-9a-f\]\{3\}\|\[0-9a-f\]\{6\}\)\$/i);
|
||
assert.match(status, /#6b7280/);
|
||
|
||
const prereply = read('assets/admin/src/pages/users/partials/ticket/TicketPrereplyPanel.vue');
|
||
// 排序接口要求全量 ID。
|
||
assert.match(prereply, /rows\.value\.map\(\(row\) => row\.id\)/);
|
||
assert.match(prereply, /reorderTicketPrereplies\(ids\)/);
|
||
});
|
||
|
||
test('no config tab residue survives in the SPA or the native page', () => {
|
||
const router = read('assets/admin/src/router/index.js');
|
||
const constants = read('assets/admin/src/constants/sections/users.js');
|
||
const schema = read('assets/admin/src/schema/sections/users/ticket.js');
|
||
|
||
for (const [file, source] of [['router', router], ['constants', constants], ['ticket schema', schema]]) {
|
||
assert.ok(!source.includes('tab=config'), `${file} still references tab=config`);
|
||
}
|
||
|
||
// 原生页不再有配置 Tab 的渲染 trait。
|
||
assert.ok(
|
||
!fs.existsSync(path.join(root, 'src/Admin/Native/UsersMenusTicketsConfig.php')),
|
||
'native config trait must be deleted'
|
||
);
|
||
});
|