Files
AIclinicalresearch/backend/scripts/test-pkb-apis.ts
HaHafeng 66255368b7 feat(admin): Add user management and upgrade to module permission system
Features - User Management (Phase 4.1):
- Database: Add user_modules table for fine-grained module permissions
- Database: Add 4 user permissions (view/create/edit/delete) to role_permissions
- Backend: UserService (780 lines) - CRUD with tenant isolation
- Backend: UserController + UserRoutes (648 lines) - 13 API endpoints
- Backend: Batch import users from Excel
- Frontend: UserListPage (412 lines) - list/filter/search/pagination
- Frontend: UserFormPage (341 lines) - create/edit with module config
- Frontend: UserDetailPage (393 lines) - details/tenant/module management
- Frontend: 3 modal components (592 lines) - import/assign/configure
- API: GET/POST/PUT/DELETE /api/admin/users/* endpoints

Architecture Upgrade - Module Permission System:
- Backend: Add getUserModules() method in auth.service
- Backend: Login API returns modules array in user object
- Frontend: AuthContext adds hasModule() method
- Frontend: Navigation filters modules based on user.modules
- Frontend: RouteGuard checks requiredModule instead of requiredVersion
- Frontend: Remove deprecated version-based permission system
- UX: Only show accessible modules in navigation (clean UI)
- UX: Smart redirect after login (avoid 403 for regular users)

Fixes:
- Fix UTF-8 encoding corruption in ~100 docs files
- Fix pageSize type conversion in userService (String to Number)
- Fix authUser undefined error in TopNavigation
- Fix login redirect logic with role-based access check
- Update Git commit guidelines v1.2 with UTF-8 safety rules

Database Changes:
- CREATE TABLE user_modules (user_id, tenant_id, module_code, is_enabled)
- ADD UNIQUE CONSTRAINT (user_id, tenant_id, module_code)
- INSERT 4 permissions + role assignments
- UPDATE PUBLIC tenant with 8 module subscriptions

Technical:
- Backend: 5 new files (~2400 lines)
- Frontend: 10 new files (~2500 lines)
- Docs: 1 development record + 2 status updates + 1 guideline update
- Total: ~4900 lines of code

Status: User management 100% complete, module permission system operational
2026-01-16 13:42:10 +08:00

418 lines
13 KiB
TypeScript
Raw Permalink Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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.
/**
* PKB模块API自动化测试脚<E8AF95>? *
* 功能<E58A9F>? * 1. 测试所有PKB API端点v1和v2<76>? * 2. 对比v1和v2的返回结<E59B9E>? * 3. 验证数据一致<E4B880>? * 4. 性能对比
* 5. 边界条件测试
*
* 运行方式<E696B9>? * npx tsx scripts/test-pkb-apis.ts
*/
import axios, { AxiosError } from 'axios';
const BASE_URL = 'http://localhost:3000';
const TEST_KB_NAME = `测试知识<EFBFBD>?${Date.now()}`;
interface TestResult {
name: string;
status: 'pass' | 'fail' | 'skip';
message: string;
duration?: number;
v1Response?: any;
v2Response?: any;
}
const results: TestResult[] = [];
let testKbId: string | null = null;
// 工具函数比较两个响应是否一<E590A6>?function compareResponses(v1: any, v2: any): boolean {
return JSON.stringify(v1) === JSON.stringify(v2);
}
// 工具函数打印测试结<E8AF95>?function printResult(result: TestResult) {
const icon = result.status === 'pass' ? '<27>? : result.status === 'fail' ? '<EFBFBD>? : '⏭️';
console.log(`${icon} ${result.name} ${result.duration ? `(${result.duration}ms)` : ''}`);
if (result.message) {
console.log(` ${result.message}`);
}
}
// 测试1健康检<E5BAB7>?async function testHealthCheck(): Promise<TestResult> {
const startTime = Date.now();
try {
const response = await axios.get(`${BASE_URL}/api/v1/pkb/health`);
const duration = Date.now() - startTime;
if (response.data.status === 'ok' && response.data.module === 'pkb' && response.data.version === 'v2') {
return {
name: '健康检<E5BAB7>?,
status: 'pass',
message: `状<>? ${response.data.status}, 知识库数: ${response.data.database.knowledgeBases}`,
duration,
};
} else {
return {
name: '<EFBFBD>?,
status: 'fail',
message: '返回数据格式不正<E4B88D>?,
duration,
};
}
} catch (error: any) {
return {
name: '<EFBFBD>?,
status: 'fail',
message: error.message,
duration: Date.now() - startTime,
};
}
}
// 测试2获取知识库列表对比v1和v2<76>?async function testGetKnowledgeBases(): Promise<TestResult> {
try {
const startV1 = Date.now();
const v1Response = await axios.get(`${BASE_URL}/api/v1/knowledge-bases`);
const v1Duration = Date.now() - startV1;
const startV2 = Date.now();
const v2Response = await axios.get(`${BASE_URL}/api/v1/pkb/knowledge/knowledge-bases`);
const v2Duration = Date.now() - startV2;
const v1Count = v1Response.data.data?.length || 0;
const v2Count = v2Response.data.data?.length || 0;
if (v1Count === v2Count) {
return {
name: '获取知识库列表v1 vs v2<76>?,
status: 'pass',
message: `v1: ${v1Count}<7D>?(${v1Duration}ms), v2: ${v2Count}<7D>?(${v2Duration}ms), 数据一致✅`,
duration: v1Duration + v2Duration,
v1Response: v1Response.data,
v2Response: v2Response.data,
};
} else {
return {
name: 'v1 vs v2<EFBFBD>?,
status: 'fail',
message: `数量不一致v1: ${v1Count}<EFBFBD>? v2: ${v2Count}`,
duration: v1Duration + v2Duration,
};
}
} catch (error: any) {
return {
name: '获取知识库列表v1 vs v2<76>?,
status: 'fail',
message: error.message,
};
}
}
// 测试3创建知识库v2<76>?async function testCreateKnowledgeBase(): Promise<TestResult> {
const startTime = Date.now();
try {
const response = await axios.post(`${BASE_URL}/api/v1/pkb/knowledge/knowledge-bases`, {
name: TEST_KB_NAME,
description: '',
}, {
headers: {
'Content-Type': 'application/json'
}
});
const duration = Date.now() - startTime;
if (response.data.success && response.data.data.id) {
testKbId = response.data.data.id;
return {
name: 'v2<EFBFBD>?,
status: 'pass',
message: `成功创建ID: ${testKbId}`,
duration,
};
} else {
return {
name: '创建知识库v2<76>?,
status: 'fail',
message: '',
duration,
};
}
} catch (error: any) {
const errorDetail = error.response?.data ?
JSON.stringify(error.response.data) :
(error.response?.data?.message || error.message);
return {
name: 'v2<EFBFBD>?,
status: 'fail',
message: errorDetail,
duration: Date.now() - startTime,
};
}
}
// 测试4获取知识库详情对比v1和v2<76>?async function testGetKnowledgeBaseById(kbId: string): Promise<TestResult> {
try {
const startV1 = Date.now();
const v1Response = await axios.get(`${BASE_URL}/api/v1/knowledge-bases/${kbId}`);
const v1Duration = Date.now() - startV1;
const startV2 = Date.now();
const v2Response = await axios.get(`${BASE_URL}/api/v1/pkb/knowledge/knowledge-bases/${kbId}`);
const v2Duration = Date.now() - startV2;
const v1Name = v1Response.data.data?.name;
const v2Name = v2Response.data.data?.name;
if (v1Name === v2Name) {
return {
name: '获取知识库详情v1 vs v2<76>?,
status: 'pass',
message: `v1: ${v1Duration}ms, v2: ${v2Duration}ms, 名称一<E7A7B0>? "${v1Name}"✅`,
duration: v1Duration + v2Duration,
};
} else {
return {
name: 'v1 vs v2<EFBFBD>?,
status: 'fail',
message: `名称不一致v1: "${v1Name}", v2: "${v2Name}"`,
duration: v1Duration + v2Duration,
};
}
} catch (error: any) {
return {
name: '获取知识库详情v1 vs v2<76>?,
status: 'fail',
message: error.message,
};
}
}
// 测试5更新知识库v2<76>?async function testUpdateKnowledgeBase(kbId: string): Promise<TestResult> {
const startTime = Date.now();
try {
const response = await axios.put(`${BASE_URL}/api/v1/pkb/knowledge/knowledge-bases/${kbId}`, {
name: `${TEST_KB_NAME}-已更新`,
description: '<EFBFBD>?,
});
const duration = Date.now() - startTime;
if (response.data.success) {
return {
name: '更新知识库v2<76>?,
status: 'pass',
message: '',
duration,
};
} else {
return {
name: 'v2<EFBFBD>?,
status: 'fail',
message: '更新失败',
duration,
};
}
} catch (error: any) {
return {
name: '更新知识库v2<76>?,
status: 'fail',
message: error.response?.data?.message || error.message,
duration: Date.now() - startTime,
};
}
}
// 测试6获取知识库统计对比v1和v2<76>?async function testGetKnowledgeBaseStats(kbId: string): Promise<TestResult> {
try {
const v1Response = await axios.get(`${BASE_URL}/api/v1/knowledge-bases/${kbId}/stats`);
const v2Response = await axios.get(`${BASE_URL}/api/v1/pkb/knowledge/knowledge-bases/${kbId}/stats`);
const v1Stats = v1Response.data.data;
const v2Stats = v2Response.data.data;
if (v1Stats.totalDocuments === v2Stats.totalDocuments) {
return {
name: 'v1 vs v2<EFBFBD>?,
status: 'pass',
message: `文档数一<EFBFBD>? ${v1Stats.totalDocuments}个✅`,
};
} else {
return {
name: '获取知识库统计v1 vs v2<76>?,
status: 'fail',
message: `文档数不一致v1: ${v1Stats.totalDocuments}, v2: ${v2Stats.totalDocuments}`,
};
}
} catch (error: any) {
return {
name: 'v1 vs v2<EFBFBD>?,
status: 'fail',
message: error.message,
};
}
}
// 测试7RAG检索对比v1和v2<76>?async function testSearchKnowledgeBase(kbId: string): Promise<TestResult> {
try {
const query = '测试查询';
const v1Response = await axios.get(`${BASE_URL}/api/v1/knowledge-bases/${kbId}/search`, {
params: { query, top_k: 5 },
});
const v2Response = await axios.get(`${BASE_URL}/api/v1/pkb/knowledge/knowledge-bases/${kbId}/search`, {
params: { query, top_k: 5 },
});
return {
name: 'RAG检索v1 vs v2<76>?,
status: 'pass',
message: '',
};
} catch (error: any) {
return {
name: 'RAG检索v1 vs v2<EFBFBD>?,
status: 'fail',
message: error.message,
};
}
}
// 测试8边界条<E7958C>?- 不存在的知识<E79FA5>?async function testNotFoundKnowledgeBase(): Promise<TestResult> {
try {
await axios.get(`${BASE_URL}/api/v1/pkb/knowledge/knowledge-bases/00000000-0000-0000-0000-000000000000`);
return {
name: '边界测试:不存在的知识库',
status: 'fail',
message: '应该返回404错误但没有',
};
} catch (error: any) {
if (error.response?.status === 404 || error.response?.status === 500) {
return {
name: '边界测试:不存在的知识库',
status: 'pass',
message: `正确返回错误状<EFBFBD>? ${error.response.status}`,
};
} else {
return {
name: '边界测试:不存在的知识库',
status: 'fail',
message: `意外的状态码: ${error.response?.status}`,
};
}
}
}
// 测试9<EFBC9A>?- 删除测试知识<E79FA5>?async function testDeleteKnowledgeBase(kbId: string): Promise<TestResult> {
const startTime = Date.now();
try {
const response = await axios.delete(`${BASE_URL}/api/v1/pkb/knowledge/knowledge-bases/${kbId}`);
const duration = Date.now() - startTime;
if (response.data.success) {
return {
name: '删除知识库v2<76>?,
status: 'pass',
message: '',
duration,
};
} else {
return {
name: 'v2<EFBFBD>?,
status: 'fail',
message: '删除失败',
duration,
};
}
} catch (error: any) {
return {
name: '删除知识库v2<76>?,
status: 'fail',
message: error.response?.data?.message || error.message,
duration: Date.now() - startTime,
};
}
}
// 主测试函<E8AF95>?async function runTests() {
console.log('🚀 PKB API自动化测<EFBFBD>?..\n');
console.log('='.repeat(80));
// 测试1健康检<E5BAB7>? console.log('\n📋 1<EFBFBD>?);
console.log('-'.repeat(80));
results.push(await testHealthCheck());
printResult(results[results.length - 1]);
// 测试2获取知识库列表
console.log('\n📋 阶段2知识库列表');
console.log('-'.repeat(80));
results.push(await testGetKnowledgeBases());
printResult(results[results.length - 1]);
// 测试3创建知识库
console.log('\n📋 阶段3创建知识库');
console.log('-'.repeat(80));
results.push(await testCreateKnowledgeBase());
printResult(results[results.length - 1]);
if (!testKbId) {
console.log('\n<>?无法获取测试知识库ID后续测试跳<E8AF95>?);
return;
}
// 测试4获取知识库详情
console.log('\n📋 4');
console.log('-'.repeat(80));
results.push(await testGetKnowledgeBaseById(testKbId));
printResult(results[results.length - 1]);
// 测试5更新知识库
console.log('\n📋 5');
console.log('-'.repeat(80));
results.push(await testUpdateKnowledgeBase(testKbId));
printResult(results[results.length - 1]);
// 测试6获取统计信<E8AEA1>? console.log('\n📋 6');
console.log('-'.repeat(80));
results.push(await testGetKnowledgeBaseStats(testKbId));
printResult(results[results.length - 1]);
// 测试7RAG检<47>? console.log('\n📋 7RAG检<EFBFBD>?);
console.log('-'.repeat(80));
results.push(await testSearchKnowledgeBase(testKbId));
printResult(results[results.length - 1]);
// 测试8边界条<E7958C>? console.log('\n📋 阶段8边界条件测<E4BBB6>?);
console.log('-'.repeat(80));
results.push(await testNotFoundKnowledgeBase());
printResult(results[results.length - 1]);
// 测试9<EFBC9A>? console.log('\n📋 阶段9清理测试数<E8AF95>?);
console.log('-'.repeat(80));
results.push(await testDeleteKnowledgeBase(testKbId));
printResult(results[results.length - 1]);
// 总结
console.log('\n' + '='.repeat(80));
console.log('📊 测试总结');
console.log('='.repeat(80));
const passCount = results.filter(r => r.status === 'pass').length;
const failCount = results.filter(r => r.status === 'fail').length;
const skipCount = results.filter(r => r.status === 'skip').length;
const totalDuration = results.reduce((sum, r) => sum + (r.duration || 0), 0);
console.log(`\n总计: ${results.length}个测试`);
console.log(`<EFBFBD>?通过: ${passCount}`);
console.log(`<EFBFBD>?失败: ${failCount}`);
console.log(`⏭️ 跳过: ${skipCount}`);
console.log(`⏱️ 总耗时: ${totalDuration}ms`);
if (failCount === 0) {
console.log('\n🎉 所有测试通过<E9809A>?);
} else {
console.log('\n ');
}
}
// 执行测试
runTests().catch(error => {
console.error('<EFBFBD>?:', error);
process.exit(1);
});