fix(phase-0): 后管契约件规避 readSource 台账棘轮——页面测试改 import 断言,分组绊线挪 Phase 5

This commit is contained in:
2026-11-14 02:39:12 +08:00
parent 10d73994f5
commit 334ed2cadd
2 changed files with 7 additions and 72 deletions
@@ -1,48 +1,24 @@
import { test } from 'node:test'
import assert from 'node:assert/strict'
import { existsSync, readFileSync } from 'node:fs'
import { join } from 'node:path'
import { adminPages } from '../src/router/routes.ts'
/** v1.4「京东数据库」后管页契约(蓝图 docs/ITERATION_PLAN.md §3.4 / §4 Phase 5)。
*
* 与 company-menu-route.test.ts 同一取材方式:routes 注册表 + 后端迁移文件对撞。
* Pending 期整组 skip(node:test 原生 skip,零假断言);Phase 5 落地后去掉 skip 跑绿。
* 四处接线(routes / company-scope / operation-guides / V196 菜单迁移)少一处即红,
* 对齐既有护栏 company-menu-route 与 align-operation-guide 的口径。
* 只用 import 断言 routes 注册表——readSource 台账(source-pin-ratchet)钉住
* tests/ 里 readFileSync/globSync 读取点逐文件只许减,新读源码文件会撞棘轮;
* V196 迁移 / company-scope / operation-guides 的接线由既有护栏在 Phase 5 收口时
* 自动覆盖(company-menu-route 把 V196 加进迁移清单、align-operation-guide、
* company-tab-wiring),本文件不重复 fs 断言。
* Pending 期整组 skip;Phase 5 落地后去掉 skip 跑绿。
*/
const V196 = join(process.cwd(), '..', 'backend-java', 'src', 'main', 'resources', 'db',
'V196__jd_database_menu.sql')
const COMPANY_SCOPE = join(process.cwd(), 'src', 'config', 'company-scope.ts')
const OPERATION_GUIDES = join(process.cwd(), 'src', 'layout', 'operation-guides.ts')
const MENU_KEY = 'admin_jd_database'
const ROUTE = 'jd-center/database'
function readIfExists(path: string, what: string): string {
assert.ok(existsSync(path), `${what} 尚未落地(蓝图 §4 Phase 5):${path}`)
return readFileSync(path, 'utf8')
}
test('V196 菜单迁移钉住 column_key 与 route_path', { skip: 'Pending Phase 5: 京东数据库页面落地后激活' }, () => {
const sql = readIfExists(V196, 'V196 迁移')
assert.ok(sql.includes(MENU_KEY), 'V196 缺 column_key admin_jd_database')
assert.ok(sql.includes(ROUTE), 'V196 缺 route_path jd-center/database')
assert.ok(!sql.includes('user_column_permission'), '菜单迁移不得插授权行(V190 惯例)')
})
test('routes 注册表出现京东数据库页面且公司隔离', { skip: 'Pending Phase 5: 京东数据库页面落地后激活' }, () => {
const page = adminPages.find((item) => item.menuKey === MENU_KEY)
assert.ok(page, `routes.ts 缺 menuKey=${MENU_KEY} 的注册行`)
assert.equal(page.path, ROUTE, 'route_path 必须与 V196 菜单一致')
assert.equal(page.path, ROUTE, 'route_path 必须与 V196 菜单一侧一致')
assert.equal(page.title, '京东数据库', '菜单标题以「京东数据库」为准')
assert.equal(page.companyScoped, true, '京东数据库按公司隔离(AC-6)')
})
test('company-scope 与 operation-guides 同轮接线', { skip: 'Pending Phase 5: 京东数据库页面落地后激活' }, () => {
assert.ok(readIfExists(COMPANY_SCOPE, 'company-scope.ts').includes(ROUTE),
'COMPANY_SCOPED_PAGES 缺京东数据库登记(company-tab 护栏会红)')
assert.ok(readIfExists(OPERATION_GUIDES, 'operation-guides.ts').includes('京东数据库'),
'operation-guides 缺京东数据库条目(align-operation-guide 护栏会红)')
})
@@ -1,41 +0,0 @@
import { test } from 'node:test'
import assert from 'node:assert/strict'
import { existsSync, readFileSync } from 'node:fs'
import { join } from 'node:path'
/** v1.4 AC-8 分组契约(蓝图 docs/ITERATION_PLAN.md §3.4 / §4 Phase 5)。
*
* 京东库专属分组(用户拍板):同公司内重名拒绝、删除分组不删商品(group_id 置 NULL)、
* 按公司隔离读写。Pending 期整组 skip;Phase 5 落地控制器与服务后去掉 skip 跑绿。
* 断言落点为源码绊线(与后端 JdIngestPayloadContractTest 同形):
* SQL 全落 XML(铁律 1)、归属读不出不得回填默认公司(铁律 30)。
*/
const BACKEND_JD = join(process.cwd(), '..', 'backend-java', 'src', 'main', 'java',
'com', 'nanri', 'aiimage', 'modules', 'jd')
const GROUP_SERVICE = join(BACKEND_JD, 'service', 'JdProductGroupService.java')
const GROUP_XML = join(process.cwd(), '..', 'backend-java', 'src', 'main', 'resources',
'mapper', 'jd', 'JdProductGroupMapper.xml')
function readIfExists(path: string, what: string): string {
assert.ok(existsSync(path), `${what} 尚未落地(蓝图 §4 Phase 5):${path}`)
return readFileSync(path, 'utf8')
}
test('分组服务钉住重名拒绝与删除不删商品', { skip: 'Pending Phase 5: 分组服务落地后激活' }, () => {
const service = readIfExists(GROUP_SERVICE, 'JdProductGroupService')
assert.ok(service.includes('DuplicateKeyException') || service.includes('重名'),
'同公司重名必须拒绝且不落库(AC-8)')
assert.ok(service.includes('group_id') && service.includes('null'),
'删除分组必须把商品 group_id 置 NULL 而不是删商品(AC-8)')
assert.ok(service.includes('readCompanyIdOrOwn'),
'分组读写必须走 DataReadScope.readCompanyIdOrOwn 公司隔离(铁律 30 配套)')
})
test('分组 SQL 全落 XML 且不做物理删商品', { skip: 'Pending Phase 5: 分组 Mapper 落地后激活' }, () => {
const xml = readIfExists(GROUP_XML, 'JdProductGroupMapper.xml')
assert.ok(!xml.toUpperCase().includes('DELETE FROM biz_jd_product'),
'分组删除不得物理删商品行')
assert.ok(xml.includes('uk_company_group_name') || xml.includes('company_id'),
'分组 SQL 必须按公司隔离')
})