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:
@@ -1,23 +1,23 @@
|
||||
# 导航结构设计文档
|
||||
|
||||
> **譁<EFBFBD>。」迚域悽<EFBFBD>?* v1.0
|
||||
> **蛻帛サコ譌・譛滂シ?* 2025-10-29
|
||||
> **扈エ謚、閠<EFBFBD>シ<EFBFBD>** 蜑咲ォッ蠑蜿大屬髦?
|
||||
> **文档版本:** v1.0
|
||||
> **创建日期:** 2025-10-29
|
||||
> **维护者:** 前端开发团队
|
||||
> **最后更新:** 2025-10-29
|
||||
|
||||
---
|
||||
|
||||
## 📋 文档说明
|
||||
|
||||
譛ャ譁<EFBFBD>。」隸ヲ扈<EFBFBD>ッエ譏拶I遘醍<EFBFBD>泌ケウ蜿ー逧<EFBFBD>ッシ闊ェ扈捺桷隶セ隶。<EFBFBD>悟桁諡ャ鬘カ驛ィ蟇シ闊ェ蜥悟キヲ萓ァ蟇シ闊ェ逧<EFBFBD>ョセ隶。隗<EFBFBD>激縲?
|
||||
本文档详细说明AI科研平台的导航结构设计,包括顶部导航和左侧导航的设计规范。
|
||||
|
||||
> **驥崎ヲ∵署遉コ<EFBFBD>?* 譛ャ譁<EFBDAC>。」荳ュ豸牙所逧<E68980>ィ。蝮礼沿譛ャ隕∵アゑシ<E38291>requiredVersion`<60>牙插荳?*蛻晏ァ矩<EFBDA7>鄂ョ**<2A>悟庄莉・譬ケ謐ョ荳壼苅髴豎る囂譌カ隹<EFBDB6>紛縲ら沿譛ャ譚<EFBDAC>剞蛻<E5899E><E89BBB>螳悟<E89EB3>蜿ッ驟咲スョ<EFBDBD>梧裏髴謾ケ蜉ィ莉」遐<EFBDA3>サ霎代?
|
||||
> **重要提示:** 本文档中涉及的模块版本要求(`requiredVersion`)均为**初始配置**,可以根据业务需求随时调整。版本权限分配完全可配置,无需改动代码逻辑。
|
||||
|
||||
---
|
||||
|
||||
## 🧭 顶部导航设计
|
||||
|
||||
### 蟇シ闊ェ鬘ケ驟咲ス?
|
||||
### 导航项配置
|
||||
|
||||
```typescript
|
||||
// navigationConfig.ts
|
||||
@@ -26,15 +26,15 @@ export interface NavigationItem {
|
||||
label: string; // 显示名称
|
||||
route: string; // 路由路径
|
||||
icon?: ReactNode; // 图标(可选)
|
||||
requiredVersion?: UserVersion; // 譛菴守沿譛ャ隕∵アゑシ亥庄驟咲スョ<EFBFBD>梧髪謖∝錘譛溯ー<EFBFBD>紛<EFBFBD>?
|
||||
requiredVersion?: UserVersion; // 最低版本要求(可配置,支持后期调整)
|
||||
standalone?: boolean; // 是否支持独立运行
|
||||
}
|
||||
|
||||
/**
|
||||
* 顶部导航配置
|
||||
*
|
||||
* 笞<EFBFBD><EFBFBD><EFBFBD> 驥崎ヲ∬ッエ譏趣シ?
|
||||
* - requiredVersion 蟄玲ョオ荳コ蛻晏ァ矩<EFBFBD>鄂ョ<EFBFBD>悟庄譬ケ謐ョ荳壼苅髴豎る囂譌カ隹<EFBFBD><EFBFBD>?
|
||||
* ⚠️ 重要说明:
|
||||
* - requiredVersion 字段为初始配置,可根据业务需求随时调整
|
||||
* - 推荐通过后端API动态获取版本配置,支持实时调整
|
||||
* - 修改版本要求无需改动代码逻辑,只需更新配置即可
|
||||
*/
|
||||
@@ -49,12 +49,12 @@ export const TOP_NAVIGATION_ITEMS: NavigationItem[] = [
|
||||
id: 'literature-platform',
|
||||
label: 'AI智能文献',
|
||||
route: '/literature',
|
||||
requiredVersion: 'advanced', // 蛻晏ァ矩<EFBFBD>鄂ョ<EFBFBD>夐ォ倡コァ迚亥庄逕ィ<EFBFBD>亥庄隹<EFBFBD>紛<EFBFBD>?
|
||||
requiredVersion: 'advanced', // 初始配置:高级版可用(可调整)
|
||||
standalone: true,
|
||||
},
|
||||
{
|
||||
id: 'knowledge-base',
|
||||
label: '遏・隸<EFBFBD>コ?,
|
||||
label: '知识库',
|
||||
route: '/knowledge-base',
|
||||
requiredVersion: 'basic', // 初始配置:基础版可用(可调整)
|
||||
},
|
||||
@@ -62,21 +62,21 @@ export const TOP_NAVIGATION_ITEMS: NavigationItem[] = [
|
||||
id: 'data-cleaning',
|
||||
label: '智能数据清洗',
|
||||
route: '/data-cleaning',
|
||||
requiredVersion: 'advanced', // 蛻晏ァ矩<EFBDA7>鄂ョ<E98482>夐ォ倡コァ迚亥庄逕ィ<E98095>亥庄隹<E5BA84>紛<EFBFBD>?
|
||||
placeholder: true, // 蜊<>菴搾シ梧仞遉?蠑蜿台クュ"
|
||||
requiredVersion: 'advanced', // 初始配置:高级版可用(可调整)
|
||||
placeholder: true, // 占位,显示"开发中"
|
||||
},
|
||||
{
|
||||
id: 'statistical-analysis',
|
||||
label: '智能统计分析',
|
||||
route: '/intelligent-analysis',
|
||||
requiredVersion: 'premium', // 蛻晏ァ矩<EFBDA7>鄂ョ<E98482>壽覧闊ー迚亥庄逕ィ<E98095>亥庄隹<E5BA84>紛<EFBFBD>?
|
||||
requiredVersion: 'premium', // 初始配置:旗舰版可用(可调整)
|
||||
external: true, // 由Java团队开发,只做顶部导航集成
|
||||
},
|
||||
{
|
||||
id: 'statistical-tools',
|
||||
label: '统计分析工具',
|
||||
route: '/statistical-tools',
|
||||
requiredVersion: 'premium', // 蛻晏ァ矩<EFBFBD>鄂ョ<EFBFBD>壽覧闊ー迚亥庄逕ィ<EFBFBD>亥庄隹<EFBFBD>紛<EFBFBD>?
|
||||
requiredVersion: 'premium', // 初始配置:旗舰版可用(可调整)
|
||||
external: true, // 由Java团队开发,只做顶部导航集成
|
||||
},
|
||||
];
|
||||
@@ -85,19 +85,19 @@ export const TOP_NAVIGATION_ITEMS: NavigationItem[] = [
|
||||
### 顶部导航布局
|
||||
|
||||
```
|
||||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||||
笏? [Logo] [AI髣ョ遲脳 [AI譎コ閭ス譁<EFBDBD>鍵] [遏・隸<EFBDA5>コ転 [譎コ閭ス謨ー謐ョ貂<EFBDAE>エ余 [譎コ閭ス扈溯ョ。蛻<EFBDA1>梵] [扈溯ョ。蛻<EFBDA1>梵蟾・蜈キ] [逕ィ謌キ蜷江 [逕ィ謌キ闖懷黒笆シ] 笏?
|
||||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||||
┌──────────────────────────────────────────────────────────────────────────┐
|
||||
│ [Logo] [AI问答] [AI智能文献] [知识库] [智能数据清洗] [智能统计分析] [统计分析工具] [用户名] [用户菜单▼] │
|
||||
└──────────────────────────────────────────────────────────────────────────┘
|
||||
160px 自适应宽度 200px
|
||||
```
|
||||
|
||||
### 视觉设计规范
|
||||
|
||||
#### 蟇シ闊ェ鬘ケ譬キ蠑?
|
||||
- **豁」蟶ク迥カ諤?*<2A>啻color: #4b5563`, `font-weight: 500`
|
||||
- **謔ャ蛛懃憾諤?*<2A>啻color: #0ea5e9`, `background: rgba(14, 165, 233, 0.1)`
|
||||
- **豼豢サ迥カ諤?*<2A>啻color: #0ea5e9`, `font-weight: 600`, `border-bottom: 2px solid #0ea5e9`
|
||||
- **遖∫畑迥カ諤?*<2A>域裏譚<E8A38F>剞<EFBFBD>会シ啻color: #9ca3af`, `cursor: not-allowed`
|
||||
#### 导航项样式
|
||||
- **正常状态**:`color: #4b5563`, `font-weight: 500`
|
||||
- **悬停状态**:`color: #0ea5e9`, `background: rgba(14, 165, 233, 0.1)`
|
||||
- **激活状态**:`color: #0ea5e9`, `font-weight: 600`, `border-bottom: 2px solid #0ea5e9`
|
||||
- **禁用状态**(无权限):`color: #9ca3af`, `cursor: not-allowed`
|
||||
|
||||
#### 间距规范
|
||||
- 导航项之间:`16px` 水平间距
|
||||
@@ -108,26 +108,26 @@ export const TOP_NAVIGATION_ITEMS: NavigationItem[] = [
|
||||
|
||||
**位置**:顶部导航最右侧
|
||||
|
||||
**譏セ遉コ蜀<EFBFBD>ョケ**<EFBFBD>?
|
||||
- 逕ィ謌キ蜷搾シ域焔譛コ蜿キ閼ア謨乗仞遉コ<EFBFBD>悟ヲゑシ啻186****8738`<EFBFBD>?
|
||||
**显示内容**:
|
||||
- 用户名(手机号脱敏显示,如:`186****8738`)
|
||||
- 用户头像/图标(点击触发下拉菜单)
|
||||
|
||||
**荳区級闖懷黒騾蛾。ケ**<EFBFBD>?
|
||||
**下拉菜单选项**:
|
||||
```
|
||||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||||
笏?荳ェ莠コ荳ュ蠢<EFBDAD> 笏?
|
||||
笏?蜴<>彰隶ー蠖<EFBDB0> 笏?
|
||||
笏?笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏 笏?
|
||||
笏?隶「髦<EFBDA2>ョ。逅<EFBDA1> 笏?
|
||||
笏?騾蜃コ雍ヲ蜿? 笏?
|
||||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||||
┌─────────────────────┐
|
||||
│ 个人中心 │
|
||||
│ 历史记录 │
|
||||
│ ──────────────── │
|
||||
│ 订阅管理 │
|
||||
│ 退出账号 │
|
||||
└─────────────────────┘
|
||||
```
|
||||
|
||||
**霍ッ逕ア霍ウ霓ャ**<EFBFBD>?
|
||||
- 荳ェ莠コ荳ュ蠢<EFBFBD> 竊?`/user/profile`
|
||||
- 蜴<EFBFBD>彰隶ー蠖<EFBFBD> 竊?`/user/history`
|
||||
- 隶「髦<EFBFBD>ョ。逅<EFBFBD> 竊?`/user/subscription`
|
||||
- 騾蜃コ雍ヲ蜿?竊?逋サ蜃コ謫堺ス<E5A0BA>
|
||||
**路由跳转**:
|
||||
- 个人中心 → `/user/profile`
|
||||
- 历史记录 → `/user/history`
|
||||
- 订阅管理 → `/user/subscription`
|
||||
- 退出账号 → 登出操作
|
||||
|
||||
---
|
||||
|
||||
@@ -135,27 +135,27 @@ export const TOP_NAVIGATION_ITEMS: NavigationItem[] = [
|
||||
|
||||
### 设计原则
|
||||
|
||||
1. **謖蛾怙譏セ遉コ**<EFBFBD>壼宵譛芽ソ帛<EFBFBD>蜈キ菴捺ィ。蝮怜錘謇肴仞遉コ蟾ヲ萓ァ蟇シ闊?
|
||||
2. **讓。蝮礼峡遶<EFBFBD>**<EFBFBD>壽ッ丈クェ讓。蝮玲怏閾ェ蟾ア迢ャ遶狗噪蟾ヲ萓ァ蟇シ闊ェ驟咲ス?
|
||||
1. **按需显示**:只有进入具体模块后才显示左侧导航
|
||||
2. **模块独立**:每个模块有自己独立的左侧导航配置
|
||||
3. **层级清晰**:支持一级和二级菜单
|
||||
|
||||
### AI问答模块左侧导航
|
||||
|
||||
**蟶<EFBFBD>ア譁ケ蠑<EFBFBD>**<EFBFBD>壼今迚<EFBFBD>シ丞ク<EFBFBD>ア<EFBFBD>井ク堺スソ逕ィ蟾ヲ萓ァ蟇シ闊ェ<EFBFBD>?
|
||||
**布局方式**:卡片式布局(不使用左侧导航)
|
||||
|
||||
```
|
||||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||||
笏? AI髣ョ遲比クサ逡碁<EFBFBD>? 笏?
|
||||
笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?
|
||||
笏? 笏? 謳懃エ「譯?+ 謠宣琉謖蛾聴 笏? 笏?
|
||||
笏? 笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?
|
||||
笏? 笏?
|
||||
笏? 謌夜画叫荳荳ェ譎コ閭ス菴灘シ蟋? 笏?
|
||||
笏? 笏娯楳笏笏笏笏?笏娯楳笏笏笏笏?笏娯楳笏笏笏笏?笏娯楳笏笏笏笏? 笏?
|
||||
笏? 笏る蛾「倪<EFBDA2>?笏1ICO笏?笏ら<E7AC8F>皮ゥカ笏<EFBDB6> 笏よ婿豕補狽 ... 笏?
|
||||
笏? 笏りッ<E3828A>サキ笏<EFBDB7> 笏よ「ウ逅<EFBDB3>狽 笏よ婿譯遺狽 笏ょュヲ 笏? 笏?
|
||||
笏? 笏披楳笏笏笏笏?笏披楳笏笏笏笏?笏披楳笏笏笏笏?笏披楳笏笏笏笏? 笏?
|
||||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||||
┌─────────────────────────────────────────┐
|
||||
│ AI问答主界面 │
|
||||
│ ┌───────────────────────────────────┐ │
|
||||
│ │ 搜索框 + 提问按钮 │ │
|
||||
│ └───────────────────────────────────┘ │
|
||||
│ │
|
||||
│ 或选择一个智能体开始: │
|
||||
│ ┌────┐ ┌────┐ ┌────┐ ┌────┐ │
|
||||
│ │选题│ │PICO│ │研究│ │方法│ ... │
|
||||
│ │评价│ │梳理│ │方案│ │学 │ │
|
||||
│ └────┘ └────┘ └────┘ └────┘ │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### AI智能文献模块左侧导航
|
||||
@@ -170,7 +170,7 @@ const LITERATURE_SIDE_NAV = [
|
||||
},
|
||||
{
|
||||
id: 'search',
|
||||
label: '譎コ閭ス譁<EFBFBD>鍵譽邏?,
|
||||
label: '智能文献检索',
|
||||
route: '/literature/search',
|
||||
icon: '🔍',
|
||||
},
|
||||
@@ -184,7 +184,7 @@ const LITERATURE_SIDE_NAV = [
|
||||
id: 'screening',
|
||||
label: '标题摘要初筛',
|
||||
route: '/literature/screening',
|
||||
icon: '笨?,
|
||||
icon: '✅',
|
||||
},
|
||||
{
|
||||
id: 'full-text',
|
||||
@@ -194,37 +194,37 @@ const LITERATURE_SIDE_NAV = [
|
||||
},
|
||||
{
|
||||
id: 'extraction',
|
||||
label: '蜈ィ譁<EFBFBD>ァ」譫蝉ク取焚謐ョ謠仙<EFBFBD>?,
|
||||
label: '全文解析与数据提取',
|
||||
route: '/literature/extraction',
|
||||
icon: '🔬',
|
||||
},
|
||||
{
|
||||
id: 'analysis',
|
||||
label: '謨ー謐ョ扈シ蜷亥<EFBFBD>譫蝉ク取冠蜻?,
|
||||
label: '数据综合分析与报告',
|
||||
route: '/literature/analysis',
|
||||
icon: '📊',
|
||||
},
|
||||
];
|
||||
```
|
||||
|
||||
**蟶<EFBFBD>ア譬キ蠑<EFBFBD>**<EFBFBD>?
|
||||
**布局样式**:
|
||||
- 宽度:`200px`
|
||||
- 背景色:`#f9fafb`
|
||||
- 激活项:`background: #e0e7ff`, `border-left: 3px solid #4f46e5`
|
||||
|
||||
### 遏・隸<EFBFBD>コ捺ィ。蝮怜キヲ萓ァ蟇シ闊?
|
||||
### 知识库模块左侧导航
|
||||
|
||||
```typescript
|
||||
const KNOWLEDGE_BASE_SIDE_NAV = [
|
||||
{
|
||||
id: 'list',
|
||||
label: '遏・隸<EFBFBD>コ灘<EFBFBD>陦?,
|
||||
label: '知识库列表',
|
||||
route: '/knowledge-base',
|
||||
icon: '📚',
|
||||
},
|
||||
{
|
||||
id: 'create',
|
||||
label: '+ 譁ー蟒コ遏・隸<EFBFBD>コ?,
|
||||
label: '+ 新建知识库',
|
||||
route: '/knowledge-base/create',
|
||||
icon: '+',
|
||||
},
|
||||
@@ -233,23 +233,23 @@ const KNOWLEDGE_BASE_SIDE_NAV = [
|
||||
|
||||
### 智能统计分析模块(外部模块说明)
|
||||
|
||||
**隸エ譏趣シ?* 譎コ閭ス扈溯ョ。蛻<EFBDA1>梵讓。蝮礼<E89DAE>?*Java蝗「髦<EFBDA2>**蠑蜿托シ碁㊦逕ィ**Java蜷守ォッ**謚譛ッ譬医?
|
||||
**謌台サャ逧<EFBFBD>′雍」<EFBFBD><EFBFBD>** 莉<>惠鬘カ驛ィ蟇シ闊ェ荳ュ髮<EFBDAD><E9ABAE>隸・讓。蝮礼噪蜈・蜿」<E89CBF>檎せ蜃サ蜷手キウ霓ャ蛻ーJava蝗「髦溷シ蜿醍噪鬘オ髱「縲?
|
||||
**隶セ隶。隗<EFBFBD>激<EFBFBD>?* 荳埼怙隕∵<E99A95>莉ャ隶セ隶。蟾ヲ萓ァ蟇シ闊ェ<E9978A>繰ava蝗「髦溷キイ譛芽<E8AD9B>蟾ア逧<EFBDB1>。オ髱「蟶<EFBDA2>ア隶セ隶。縲?
|
||||
**说明:** 智能统计分析模块由**Java团队**开发,采用**Java后端**技术栈。
|
||||
**我们的职责:** 仅在顶部导航中集成该模块的入口,点击后跳转到Java团队开发的页面。
|
||||
**设计规范:** 不需要我们设计左侧导航,Java团队已有自己的页面布局设计。
|
||||
|
||||
**髮<EFBFBD><EFBFBD>譁ケ蠑擾シ?*
|
||||
- 鬘カ驛ィ蟇シ闊ェ轤ケ蜃サ蜷趣シ檎峩謗・霍ウ霓ャ蛻?`/intelligent-analysis` 霍ッ逕ア
|
||||
**集成方式:**
|
||||
- 顶部导航点击后,直接跳转到 `/intelligent-analysis` 路由
|
||||
- 该路由可能指向独立的Java应用或iframe嵌入
|
||||
- 具体集成方式需与Java团队协商确定
|
||||
|
||||
### 统计分析工具模块(外部模块说明)
|
||||
|
||||
**隸エ譏趣シ?* 扈溯ョ。蛻<EFBDA1>梵蟾・蜈キ讓。蝮礼<E89DAE>?*Java蝗「髦<EFBDA2>**蠑蜿托シ碁㊦逕ィ**Java蜷守ォッ**謚譛ッ譬医?
|
||||
**謌台サャ逧<EFBFBD>′雍」<EFBFBD><EFBFBD>** 莉<>惠鬘カ驛ィ蟇シ闊ェ荳ュ髮<EFBDAD><E9ABAE>隸・讓。蝮礼噪蜈・蜿」<E89CBF>檎せ蜃サ蜷手キウ霓ャ蛻ーJava蝗「髦溷シ蜿醍噪鬘オ髱「縲?
|
||||
**隶セ隶。隗<EFBFBD>激<EFBFBD>?* 隸・讓。蝮?*荳肴弍蟾ヲ萓ァ蟇シ闊ェ隶セ隶。**<EFBFBD>繰ava蝗「髦滓怏閾ェ蟾ア逧<EFBFBD>。オ髱「蟶<EFBFBD>ア<EFBFBD>亥ヲる。カ驛ィTab蟇シ闊ェ遲会シ峨?
|
||||
**说明:** 统计分析工具模块由**Java团队**开发,采用**Java后端**技术栈。
|
||||
**我们的职责:** 仅在顶部导航中集成该模块的入口,点击后跳转到Java团队开发的页面。
|
||||
**设计规范:** 该模块**不是左侧导航设计**,Java团队有自己的页面布局(如顶部Tab导航等)。
|
||||
|
||||
**髮<EFBFBD><EFBFBD>譁ケ蠑擾シ?*
|
||||
- 鬘カ驛ィ蟇シ闊ェ轤ケ蜃サ蜷趣シ檎峩謗・霍ウ霓ャ蛻?`/statistical-tools` 霍ッ逕ア
|
||||
**集成方式:**
|
||||
- 顶部导航点击后,直接跳转到 `/statistical-tools` 路由
|
||||
- 该路由可能指向独立的Java应用或iframe嵌入
|
||||
- 具体集成方式需与Java团队协商确定
|
||||
|
||||
@@ -260,9 +260,9 @@ const KNOWLEDGE_BASE_SIDE_NAV = [
|
||||
### 顶部导航切换
|
||||
|
||||
```typescript
|
||||
// 轤ケ蜃サ鬘カ驛ィ蟇シ闊ェ鬘?
|
||||
// 点击顶部导航项
|
||||
const handleNavClick = (item: NavigationItem) => {
|
||||
// 1. 譽譟・譚<EFBFBD><EFBFBD>?
|
||||
// 1. 检查权限
|
||||
if (!hasPermission(item.requiredVersion)) {
|
||||
showUpgradePrompt(item);
|
||||
return;
|
||||
@@ -274,10 +274,10 @@ const handleNavClick = (item: NavigationItem) => {
|
||||
return;
|
||||
}
|
||||
|
||||
// 3. 蟇シ闊ェ蛻ー逶ョ譬<EFBFBD>キッ逕?
|
||||
// 3. 导航到目标路由
|
||||
navigate(item.route);
|
||||
|
||||
// 4. 譖エ譁ー豼豢サ迥カ諤?
|
||||
// 4. 更新激活状态
|
||||
setActiveNavItem(item.id);
|
||||
};
|
||||
```
|
||||
@@ -285,12 +285,12 @@ const handleNavClick = (item: NavigationItem) => {
|
||||
### 左侧导航切换
|
||||
|
||||
```typescript
|
||||
// 轤ケ蜃サ蟾ヲ萓ァ蟇シ闊ェ鬘?
|
||||
// 点击左侧导航项
|
||||
const handleSideNavClick = (item: SideNavItem) => {
|
||||
// 蟇シ闊ェ蛻ー逶ョ譬<EFBFBD>キッ逕ア<EFBFBD>域ィ。蝮怜<EFBFBD>驛ィ霍ッ逕ア<EFBFBD>?
|
||||
// 导航到目标路由(模块内部路由)
|
||||
navigate(item.route);
|
||||
|
||||
// 譖エ譁ー豼豢サ迥カ諤?
|
||||
// 更新激活状态
|
||||
setActiveSideNavItem(item.id);
|
||||
};
|
||||
```
|
||||
@@ -300,24 +300,24 @@ const handleSideNavClick = (item: SideNavItem) => {
|
||||
对于深层级页面,建议添加面包屑导航:
|
||||
|
||||
```
|
||||
鬥夜。オ > AI譎コ閭ス譁<EFBFBD>鍵 > 譬<>「俶遭隕∝<E99A95>遲<EFBFBD> > 螳。譬ク蟾・菴懷<E88FB4>?
|
||||
首页 > AI智能文献 > 标题摘要初筛 > 审核工作台
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## <EFBFBD>導 蜩榊コ泌シ剰ョセ隶?
|
||||
## 📱 响应式设计
|
||||
|
||||
### 譯碁擇遶?(>1024px)
|
||||
### 桌面端 (>1024px)
|
||||
- 完整显示所有顶部导航项
|
||||
- 譏セ遉コ螳梧紛逧<EFBFBD>キヲ萓ァ蟇シ闊?
|
||||
- 显示完整的左侧导航
|
||||
|
||||
### 蟷ウ譚ソ遶?(768-1024px)
|
||||
- 譏セ遉コ蜑?荳ェ鬘カ驛ィ蟇シ闊ェ鬘ケ
|
||||
### 平板端 (768-1024px)
|
||||
- 显示前4个顶部导航项
|
||||
- 其余导航项折叠到"更多"菜单
|
||||
- 蟾ヲ萓ァ蟇シ闊ェ蜿ッ謚伜匠荳コ謚ス螻牙シ?
|
||||
- 左侧导航可折叠为抽屉式
|
||||
|
||||
### 遘サ蜉ィ遶?(<768px)
|
||||
- 鬘カ驛ィ蟇シ闊ェ驥<EFBFBD>畑豎牙<EFBFBD>。闖懷黒<EFBFBD>遺于<EFBFBD>?
|
||||
### 移动端 (<768px)
|
||||
- 顶部导航采用汉堡菜单(☰)
|
||||
- 左侧导航改为底部Tab导航或抽屉式
|
||||
|
||||
---
|
||||
@@ -336,7 +336,7 @@ const handleSideNavClick = (item: SideNavItem) => {
|
||||
--nav-text-active: #0ea5e9;
|
||||
--nav-active-border: #0ea5e9;
|
||||
|
||||
/* 萓ァ霎ケ譬城「懆<EFBFBD>?*/
|
||||
/* 侧边栏颜色 */
|
||||
--sidebar-bg: #f9fafb;
|
||||
--sidebar-active-bg: #e0e7ff;
|
||||
--sidebar-active-border: #4f46e5;
|
||||
@@ -354,7 +354,7 @@ const handleSideNavClick = (item: SideNavItem) => {
|
||||
|
||||
## 📝 实施清单
|
||||
|
||||
### 扈<EFBFBD>サカ蠑蜿?
|
||||
### 组件开发
|
||||
- [ ] `TopNavigation.tsx` - 顶部导航组件
|
||||
- [ ] `SideNavigation.tsx` - 左侧导航组件
|
||||
- [ ] `UserMenu.tsx` - 用户菜单组件
|
||||
@@ -364,16 +364,16 @@ const handleSideNavClick = (item: SideNavItem) => {
|
||||
### 配置文件
|
||||
- [ ] `navigationConfig.ts` - 导航配置
|
||||
- [ ] `moduleNavConfig.ts` - 模块导航配置
|
||||
- [ ] `versionConfig.ts` - 迚域悽驟咲スョ<EFBFBD>域悽蝨ー驟咲スョ<EFBFBD>御ス應クコ蜈懷コ包シ?
|
||||
- [ ] `versionConfig.ts` - 版本配置(本地配置,作为兜底)
|
||||
- [ ] `useVersionConfig.ts` - 版本配置Hook(从API动态获取)
|
||||
|
||||
### 文档
|
||||
- [ ] 譖エ譁ー譛ャ譁<EFBFBD>。?
|
||||
- [ ] 更新本文档
|
||||
- [ ] 编写导航组件使用文档
|
||||
|
||||
---
|
||||
|
||||
**譁<EFBFBD>。」迚域悽<EFBFBD>?* v1.0
|
||||
**文档版本:** v1.0
|
||||
**最后更新:** 2025-10-29
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user