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
This commit is contained in:
2026-01-16 13:42:10 +08:00
parent 98d862dbd4
commit 66255368b7
560 changed files with 70424 additions and 52353 deletions

View File

@@ -1,15 +1,15 @@
/**
* PKB<EFBFBD>API<EFBFBD>芸𢆡<EFBFBD>𡝗<EFBFBD>霂閗<EFBFBD><EFBFBD>? *
* <20><EFBFBD>? * 1. 瘚贝<EFBFBD><EFBFBD><EFBFBD><EFBFBD>侨KB API蝡舐<E89DA1>嚗ǒ1<C792>綋2嚗? * 2. 撖寞<E69296>v1<76>綋2<E7B68B><32><EFBFBD><EFBFBD><EFBFBD><E482BF>? * 3. 撉諹<E69289><E8ABB9>唳旿銝<E697BF><E98A9D><EFBFBD>? * 4. <EFBFBD><EFBFBD>撖寞<EFBFBD>
* PKB模块API自动化测试脚<EFBFBD>? *
* 功能<EFBFBD>? * 1. 测试所有PKB API端点v1和v2<76>? * 2. 对比v1和v2的返回结<E59B9E>? * 3. 验证数据一致<EFBFBD>? * 4. 性能对比
* 5. 边界条件测试
*
* 餈鞱<EFBFBD><EFBFBD><EFBFBD>? * npx tsx scripts/test-pkb-apis.ts
* 运行方式<EFBFBD>? * npx tsx scripts/test-pkb-apis.ts
*/
import axios, { AxiosError } from 'axios';
const BASE_URL = 'http://localhost:3000';
const TEST_KB_NAME = `瘚贝<EFBFBD><EFBFBD><EFBFBD>?${Date.now()}`;
const TEST_KB_NAME = `测试知识<EFBFBD>?${Date.now()}`;
interface TestResult {
name: string;
@@ -23,19 +23,19 @@ interface TestResult {
const results: TestResult[] = [];
let testKbId: string | null = null;
// 撌亙<EFBFBD><EFBFBD>賣㺭嚗𡁏<EFBFBD><EFBFBD>舅銝芸<EFBFBD>摨娍糓<EFBFBD><EFBFBD><EFBFBD>?function compareResponses(v1: any, v2: any): boolean {
// 工具函数:比较两个响应是否一<EFBFBD>?function compareResponses(v1: any, v2: any): boolean {
return JSON.stringify(v1) === JSON.stringify(v2);
}
// 撌亙<EFBFBD><EFBFBD>賣㺭嚗𡁏<EFBFBD><EFBFBD><EFBFBD>霂閧<EFBFBD><EFBFBD>?function printResult(result: TestResult) {
const icon = result.status === 'pass' ? '<27>? : result.status === 'fail' ? '<EFBFBD>? : '<EFBFBD><EFBFBD>';
// 工具函数:打印测试结<EFBFBD>?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}`);
}
}
// 瘚贝<EFBFBD>1嚗𡁜<EFBFBD>摨瑟<EFBFBD><EFBFBD>?async function testHealthCheck(): Promise<TestResult> {
// 测试1健康检<EFBFBD>?async function testHealthCheck(): Promise<TestResult> {
const startTime = Date.now();
try {
const response = await axios.get(`${BASE_URL}/api/v1/pkb/health`);
@@ -43,22 +43,22 @@ let testKbId: string | null = null;
if (response.data.status === 'ok' && response.data.module === 'pkb' && response.data.version === 'v2') {
return {
name: '<EFBFBD>亙熒璉<EFBFBD><EFBFBD>?,
name: '健康检<EFBFBD>?,
status: 'pass',
message: `<EFBFBD><EFBFBD>? ${response.data.status}, <EFBFBD><EFBFBD>摨𤘪㺭: ${response.data.database.knowledgeBases}`,
message: `<EFBFBD>? ${response.data.status}, 知识库数: ${response.data.database.knowledgeBases}`,
duration,
};
} else {
return {
name: '<EFBFBD><EFBFBD><EFBFBD>?,
name: '<EFBFBD>?,
status: 'fail',
message: '餈𥪜<EFBFBD><EFBFBD>唳旿<EFBFBD><EFBFBD>銝齿迤蝖?,
message: '返回数据格式不正<EFBFBD>?,
duration,
};
}
} catch (error: any) {
return {
name: '<EFBFBD><EFBFBD><EFBFBD>?,
name: '<EFBFBD>?,
status: 'fail',
message: error.message,
duration: Date.now() - startTime,
@@ -66,7 +66,7 @@ let testKbId: string | null = null;
}
}
// 瘚贝<EFBFBD>2嚗朞繮<EFBFBD>𣇉䰻霂<EFBFBD><EFBFBD><EFBFBD>𡑒”嚗<EFBFBD>笆瘥畕1<EFBFBD>綋2嚗?async function testGetKnowledgeBases(): Promise<TestResult> {
// 测试2获取知识库列表对比v1和v2<EFBFBD>?async function testGetKnowledgeBases(): Promise<TestResult> {
try {
const startV1 = Date.now();
const v1Response = await axios.get(`${BASE_URL}/api/v1/knowledge-bases`);
@@ -81,31 +81,31 @@ let testKbId: string | null = null;
if (v1Count === v2Count) {
return {
name: '<EFBFBD><EFBFBD><EFBFBD><EFBFBD>摨枏<EFBFBD>銵剁<EFBFBD>v1 vs v2?,
name: '获取知识库列表(v1 vs v2<EFBFBD>?,
status: 'pass',
message: `v1: ${v1Count}?(${v1Duration}ms), v2: ${v2Count}?(${v2Duration}ms), <EFBFBD>唳旿銝<EFBFBD><EFBFBD><EFBFBD>`,
message: `v1: ${v1Count}<EFBFBD>?(${v1Duration}ms), v2: ${v2Count}<EFBFBD>?(${v2Duration}ms), 数据一致✅`,
duration: v1Duration + v2Duration,
v1Response: v1Response.data,
v2Response: v2Response.data,
};
} else {
return {
name: '<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>v1 vs v2?,
name: 'v1 vs v2<EFBFBD>?,
status: 'fail',
message: `<EFBFBD><EFBFBD>銝滢<EFBFBD><EFBFBD><EFBFBD>v1: ${v1Count}? v2: ${v2Count}銝注,
message: `数量不一致!v1: ${v1Count}<EFBFBD>? v2: ${v2Count}`,
duration: v1Duration + v2Duration,
};
}
} catch (error: any) {
return {
name: '<27><EFBFBD><E79195><EFBFBD>摨枏<E691A8>銵剁<E98AB5>v1 vs v2?,
name: '获取知识库列表(v1 vs v2<EFBFBD>?,
status: 'fail',
message: error.message,
};
}
}
// 瘚贝<EFBFBD>3嚗𡁜<EFBFBD>撱箇䰻霂<EFBFBD><EFBFBD>嚗ǒ2嚗?async function testCreateKnowledgeBase(): Promise<TestResult> {
// 测试3创建知识库v2<EFBFBD>?async function testCreateKnowledgeBase(): Promise<TestResult> {
const startTime = Date.now();
try {
const response = await axios.post(`${BASE_URL}/api/v1/pkb/knowledge/knowledge-bases`, {
@@ -121,14 +121,14 @@ let testKbId: string | null = null;
if (response.data.success && response.data.data.id) {
testKbId = response.data.data.id;
return {
name: '<EFBFBD>𥕦遣<EFBFBD><EFBFBD>摨橒<EFBFBD>v2嚗?,
name: 'v2<EFBFBD>?,
status: 'pass',
message: `成功创建ID: ${testKbId}`,
duration,
};
} else {
return {
name: '<27>𥕦遣<F0A595A6><EFBFBD>摨橒<E691A8>v2?,
name: '创建知识库(v2<EFBFBD>?,
status: 'fail',
message: '',
duration,
@@ -139,7 +139,7 @@ let testKbId: string | null = null;
JSON.stringify(error.response.data) :
(error.response?.data?.message || error.message);
return {
name: '<EFBFBD>𥕦遣<EFBFBD><EFBFBD>摨橒<EFBFBD>v2嚗?,
name: 'v2<EFBFBD>?,
status: 'fail',
message: errorDetail,
duration: Date.now() - startTime,
@@ -147,7 +147,7 @@ let testKbId: string | null = null;
}
}
// 瘚贝<EFBFBD>4嚗朞繮<EFBFBD>𣇉䰻霂<EFBFBD><EFBFBD>霂行<EFBFBD><EFBFBD>笆瘥畕1<EFBFBD>綋2嚗?async function testGetKnowledgeBaseById(kbId: string): Promise<TestResult> {
// 测试4获取知识库详情对比v1和v2<EFBFBD>?async function testGetKnowledgeBaseById(kbId: string): Promise<TestResult> {
try {
const startV1 = Date.now();
const v1Response = await axios.get(`${BASE_URL}/api/v1/knowledge-bases/${kbId}`);
@@ -162,14 +162,14 @@ let testKbId: string | null = null;
if (v1Name === v2Name) {
return {
name: '<27><EFBFBD><E79195><EFBFBD>摨栞祕<E6A09E><E7A595><EFBFBD>v1 vs v2?,
name: '获取知识库详情(v1 vs v2<EFBFBD>?,
status: 'pass',
message: `v1: ${v1Duration}ms, v2: ${v2Duration}ms, <EFBFBD><EFBFBD><EFBFBD>? "${v1Name}"<EFBFBD><EFBFBD>,
message: `v1: ${v1Duration}ms, v2: ${v2Duration}ms, 名称一<E7A7B0>? "${v1Name}"✅`,
duration: v1Duration + v2Duration,
};
} else {
return {
name: '<27><EFBFBD><E79195><EFBFBD>摨栞祕<E6A09E><E7A595><EFBFBD>v1 vs v2嚗?,
name: 'v1 vs v2<EFBFBD>?,
status: 'fail',
message: `名称不一致v1: "${v1Name}", v2: "${v2Name}"`,
duration: v1Duration + v2Duration,
@@ -177,32 +177,32 @@ let testKbId: string | null = null;
}
} catch (error: any) {
return {
name: '<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>v1 vs v2嚗?,
name: '获取知识库详情v1 vs v2<76>?,
status: 'fail',
message: error.message,
};
}
}
// 瘚贝<EFBFBD>5嚗𡁏凒<EFBFBD>啁䰻霂<EFBFBD><EFBFBD>嚗ǒ2嚗?async function testUpdateKnowledgeBase(kbId: string): Promise<TestResult> {
// 测试5更新知识库v2<EFBFBD>?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>讛膩撌脫凒<EFBFBD>?,
description: '<EFBFBD>?,
});
const duration = Date.now() - startTime;
if (response.data.success) {
return {
name: '<27>湔鰵<E6B994><EFBFBD>摨橒<E691A8>v2?,
name: '更新知识库(v2<EFBFBD>?,
status: 'pass',
message: '',
duration,
};
} else {
return {
name: '<EFBFBD>湔鰵<EFBFBD><EFBFBD>摨橒<EFBFBD>v2嚗?,
name: 'v2<EFBFBD>?,
status: 'fail',
message: '更新失败',
duration,
@@ -210,7 +210,7 @@ let testKbId: string | null = null;
}
} catch (error: any) {
return {
name: '<27>湔鰵<E6B994><EFBFBD>摨橒<E691A8>v2?,
name: '更新知识库(v2<EFBFBD>?,
status: 'fail',
message: error.response?.data?.message || error.message,
duration: Date.now() - startTime,
@@ -218,7 +218,7 @@ let testKbId: string | null = null;
}
}
// 瘚贝<EFBFBD>6嚗朞繮<EFBFBD>𣇉䰻霂<EFBFBD><EFBFBD>蝏蠘恣嚗<EFBFBD>笆瘥畕1<EFBFBD>綋2嚗?async function testGetKnowledgeBaseStats(kbId: string): Promise<TestResult> {
// 测试6获取知识库统计对比v1和v2<EFBFBD>?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`);
@@ -228,27 +228,27 @@ let testKbId: string | null = null;
if (v1Stats.totalDocuments === v2Stats.totalDocuments) {
return {
name: '<EFBFBD><EFBFBD><EFBFBD><EFBFBD>摨梶<EFBFBD>霈∴<EFBFBD>v1 vs v2嚗?,
name: 'v1 vs v2<EFBFBD>?,
status: 'pass',
message: `<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>? ${v1Stats.totalDocuments}<EFBFBD>`,
message: `文档数一<EFBFBD>? ${v1Stats.totalDocuments}个✅`,
};
} else {
return {
name: '<27><EFBFBD><E79195><EFBFBD>摨梶<E691A8>霈∴<E99C88>v1 vs v2?,
name: '获取知识库统计(v1 vs v2<EFBFBD>?,
status: 'fail',
message: `文档数不一致v1: ${v1Stats.totalDocuments}, v2: ${v2Stats.totalDocuments}`,
};
}
} catch (error: any) {
return {
name: '<EFBFBD><EFBFBD><EFBFBD><EFBFBD>摨梶<EFBFBD>霈∴<EFBFBD>v1 vs v2嚗?,
name: 'v1 vs v2<EFBFBD>?,
status: 'fail',
message: error.message,
};
}
}
// 瘚贝<EFBFBD>7嚗鑹AG璉<EFBFBD><EFBFBD>撖寞<EFBFBD>v1<EFBFBD>綋2嚗?async function testSearchKnowledgeBase(kbId: string): Promise<TestResult> {
// 测试7RAG检索对比v1和v2<EFBFBD>?async function testSearchKnowledgeBase(kbId: string): Promise<TestResult> {
try {
const query = '测试查询';
const v1Response = await axios.get(`${BASE_URL}/api/v1/knowledge-bases/${kbId}/search`, {
@@ -259,20 +259,20 @@ let testKbId: string | null = null;
});
return {
name: 'RAG璉<47><E89D9D>v1 vs v2?,
name: 'RAG检索v1 vs v2<EFBFBD>?,
status: 'pass',
message: '',
};
} catch (error: any) {
return {
name: 'RAG<EFBFBD><EFBFBD>v1 vs v2嚗?,
name: 'RAG检索v1 vs v2<EFBFBD>?,
status: 'fail',
message: error.message,
};
}
}
// 瘚贝<EFBFBD>8嚗朞器<EFBFBD>峕辺隞?- 銝滚<E98A9D><E6BB9A><EFBFBD><E587BD><EFBFBD>?async function testNotFoundKnowledgeBase(): Promise<TestResult> {
// 测试8边界条<EFBFBD>?- 不存在的知识<E79FA5>?async function testNotFoundKnowledgeBase(): Promise<TestResult> {
try {
await axios.get(`${BASE_URL}/api/v1/pkb/knowledge/knowledge-bases/00000000-0000-0000-0000-000000000000`);
return {
@@ -285,7 +285,7 @@ let testKbId: string | null = null;
return {
name: '边界测试:不存在的知识库',
status: 'pass',
message: `<EFBFBD>𥪜<EFBFBD><EFBFBD><EFBFBD><EFBFBD>? ${error.response.status}<EFBFBD><EFBFBD>,
message: `正确返回错误状<EFBFBD>? ${error.response.status}`,
};
} else {
return {
@@ -297,7 +297,7 @@ let testKbId: string | null = null;
}
}
// 瘚贝<EFBFBD>9嚗𡁏<EFBFBD><EFBFBD>?- <20>𣳇膄瘚贝<E7989A><E8B49D><EFBFBD>?async function testDeleteKnowledgeBase(kbId: string): Promise<TestResult> {
// 测试9<EFBFBD>?- 删除测试知识<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}`);
@@ -305,14 +305,14 @@ let testKbId: string | null = null;
if (response.data.success) {
return {
name: '<EFBFBD>𣳇膄<EFBFBD><EFBFBD>摨橒<EFBFBD>v2?,
name: '删除知识库(v2<EFBFBD>?,
status: 'pass',
message: '',
duration,
};
} else {
return {
name: '<EFBFBD>𣳇<EFBFBD><EFBFBD><EFBFBD>v2嚗?,
name: 'v2<EFBFBD>?,
status: 'fail',
message: '删除失败',
duration,
@@ -320,7 +320,7 @@ let testKbId: string | null = null;
}
} catch (error: any) {
return {
name: '<EFBFBD>𣳇膄<EFBFBD><EFBFBD>摨橒<EFBFBD>v2?,
name: '删除知识库(v2<EFBFBD>?,
status: 'fail',
message: error.response?.data?.message || error.message,
duration: Date.now() - startTime,
@@ -328,11 +328,11 @@ let testKbId: string | null = null;
}
}
// 銝餅<EFBFBD>霂訫遆<EFBFBD>?async function runTests() {
console.log('<EFBFBD><EFBFBD> <EFBFBD>KB API<EFBFBD>𢆡<EFBFBD>𡝗<EFBFBD>?..\n');
// 主测试函<EFBFBD>?async function runTests() {
console.log('🚀 PKB API自动化测<EFBFBD>?..\n');
console.log('='.repeat(80));
// 瘚贝<EFBFBD>1嚗𡁜<EFBFBD>摨瑟<EFBFBD><EFBFBD>? console.log('\n<EFBFBD><EFBFBD> <EFBFBD>1𡁜<EFBFBD><EFBFBD><EFBFBD>?);
// 测试1健康检<EFBFBD>? console.log('\n📋 1<EFBFBD>?);
console.log('-'.repeat(80));
results.push(await testHealthCheck());
printResult(results[results.length - 1]);
@@ -350,7 +350,7 @@ let testKbId: string | null = null;
printResult(results[results.length - 1]);
if (!testKbId) {
console.log('\n<>?<EFBFBD><EFBFBD><EFBFBD><EFBFBD>瘚贝<EFBFBD><EFBFBD><EFBFBD>摨𨧻D嚗<EFBFBD><EFBFBD>蝏剜<EFBFBD>霂閗歲餈?);
console.log('\n<>?无法获取测试知识库ID后续测试跳<EFBFBD>?);
return;
}
@@ -366,22 +366,22 @@ let testKbId: string | null = null;
results.push(await testUpdateKnowledgeBase(testKbId));
printResult(results[results.length - 1]);
// 瘚贝<EFBFBD>6嚗朞繮<EFBFBD>𣇉<EFBFBD>霈∩縑<EFBFBD>? console.log('\n<EFBFBD><EFBFBD> <EFBFBD>6𡁶<EFBFBD><EFBFBD>');
// 测试6获取统计信<EFBFBD>? console.log('\n📋 6');
console.log('-'.repeat(80));
results.push(await testGetKnowledgeBaseStats(testKbId));
printResult(results[results.length - 1]);
// 瘚贝<EFBFBD>7嚗鑹AG璉<EFBFBD>? console.log('\n<EFBFBD><EFBFBD> <EFBFBD>7AG<EFBFBD>?);
// 测试7RAG检<EFBFBD>? console.log('\n📋 7RAG<EFBFBD>?);
console.log('-'.repeat(80));
results.push(await testSearchKnowledgeBase(testKbId));
printResult(results[results.length - 1]);
// 瘚贝<EFBFBD>8嚗朞器<EFBFBD>峕辺隞? console.log('\n<EFBFBD><EFBFBD> <20>嗆挾8嚗朞器<E69C9E>峕辺隞嗆<E99A9E>?);
// 测试8边界条<EFBFBD>? console.log('\n📋 阶段8边界条件测<E4BBB6>?);
console.log('-'.repeat(80));
results.push(await testNotFoundKnowledgeBase());
printResult(results[results.length - 1]);
// 瘚贝<EFBFBD>9嚗𡁏<EFBFBD><EFBFBD>? console.log('\n<EFBFBD><EFBFBD> <20>嗆挾9嚗𡁏<E59A97><F0A1818F><EFBFBD><EFBFBD>霂閙㺭<EFBFBD>?);
// 测试9<EFBFBD>? console.log('\n📋 阶段9清理测试数<EFBFBD>?);
console.log('-'.repeat(80));
results.push(await testDeleteKnowledgeBase(testKbId));
printResult(results[results.length - 1]);
@@ -397,13 +397,13 @@ let testKbId: string | null = null;
const totalDuration = results.reduce((sum, r) => sum + (r.duration || 0), 0);
console.log(`\n总计: ${results.length}个测试`);
console.log(`<EFBFBD>?<EFBFBD><EFBFBD>: ${passCount});
console.log(`<EFBFBD>?憭梯揖: ${failCount}銝注);
console.log(`<EFBFBD>?通过: ${passCount}`);
console.log(`<EFBFBD>?失败: ${failCount}`);
console.log(`⏭️ 跳过: ${skipCount}`);
console.log(`⏱️ 总耗时: ${totalDuration}ms`);
if (failCount === 0) {
console.log('\n<EFBFBD><EFBFBD> <20><><EFBFBD><EFBFBD>霂閖<E99C82><EFBFBD>?);
console.log('\n🎉 所有测试通过<E9809A>?);
} else {
console.log('\n ');
}
@@ -411,7 +411,7 @@ let testKbId: string | null = null;
// 执行测试
runTests().catch(error => {
console.error('<EFBFBD>?<EFBFBD><EFBFBD><EFBFBD>:', error);
console.error('<EFBFBD>?:', error);
process.exit(1);
});