服务打包初步结构

2026-01-02 14:56:14 +08:00
parent 19026c1b30
commit 89bc8bf1d4
77 changed files with 5290 additions and 2070 deletions
--- a/urbanLifelineServ/.bin/database/postgres/sql/admin_routes_architecture.md
+++ b/urbanLifelineServ/.bin/database/postgres/sql/admin_routes_architecture.md
@@ -1,229 +0,0 @@
-# 管理后台路由架构说明
-
-## 三层架构设计
-
-### 第一层：外层主 Sidebar (platform 服务)
-显示在平台主界面的侧边栏，包含用户应用和管理后台入口。
-
-**布局**: `SidebarLayout`  
-**服务**: `platform`
-
-#### 用户应用入口
- 泰豪AI助手 (`/aichat`)
- 全部应用 (`/agents`)
- 智能体编排 (`/app/workflow`) - iframe
- 招标助手 (`/app/bidding`) - iframe
- 泰豪小电 (`/app/workcase`) - iframe
-
-#### 管理后台入口（iframe类型）
-1. **平台管理后台** (`/admin/platform`)
-   - iframe_url: `/platform/admin`
-   - 权限: `perm_platform_admin`
-
-2. **智能标书管理后台** (`/admin/bidding`)
-   - iframe_url: `/bidding/admin`
-   - 权限: `perm_bidding_admin`
-
-3. **泰豪小电管理后台** (`/admin/workcase`)
-   - iframe_url: `/workcase/admin`
-   - 权限: `perm_workcase_admin`
-
---
-
-### 第二层：SubSidebarLayout (各服务内部)
-每个管理后台的内部二级菜单，使用 `SubSidebarLayout` 布局。
-
-**布局**: `SubSidebarLayout`  
-**类型**: `route`（非 iframe）
-
---
-
-## Platform 管理后台（第二层）
-
-**服务**: `platform`  
-**布局**: `SubSidebarLayout`
-
-### 视图列表
-
-| 序号 | 视图名称 | URL | 组件路径 | 权限 |
-|------|---------|-----|----------|------|
-| 1 | 数据概览 | `/admin/overview` | `admin/overview/OverviewView.vue` | `perm_platform_admin_overview` |
-| 2 | 用户管理 | `/admin/user` | `admin/user/UserView.vue` | `perm_platform_admin_user` |
-| 3 | 知识库 | `/admin/knowledge` | `admin/knowledge/KnowledgeView.vue` | `perm_platform_admin_knowledge` |
-| 4 | 系统配置 | `/admin/config` | `admin/config/ConfigView.vue` | `perm_platform_admin_config` |
-
-### 权限配置
-```sql
-- 管理后台入口权限
-PERM-0601: perm_platform_admin (platform:admin:view)
-
-- 内部功能权限
-PERM-0602: perm_platform_admin_overview (platform:admin:overview)
-PERM-0603: perm_platform_admin_user (platform:admin:user)
-PERM-0604: perm_platform_admin_knowledge (platform:admin:knowledge)
-PERM-0605: perm_platform_admin_config (platform:admin:config)
-```
-
---
-
-## Bidding 管理后台（第二层）
-
-**服务**: `bidding`  
-**布局**: `SubSidebarLayout`
-
-### 权限配置
-```sql
-- 管理后台入口权限
-PERM-0611: perm_bidding_admin (bidding:admin:view)
-```
-
-*注: bidding 管理后台的具体视图需要后续配置*
-
---
-
-## Workcase 管理后台（第二层）
-
-**服务**: `workcase`  
-**布局**: `SubSidebarLayout`
-
-### 视图列表
-
-| 序号 | 视图名称 | URL | 组件路径 | 权限 |
-|------|---------|-----|----------|------|
-| 1 | 数据概览 | `/admin/overview` | `admin/overview/OverviewView.vue` | `perm_workcase_overview` |
-| 2 | 知识库管理 | `/admin/knowledge` | `admin/knowledge/KnowLedgeView.vue` | `perm_workcase_knowledge` |
-| 3 | 工单管理 | `/admin/workcase` | `admin/workcase/WorkcaseView.vue` | `perm_workcase_tickets` |
-| 4 | 对话数据 | `/admin/customerChat` | `admin/customerChat/CustomerChatView.vue` | `perm_workcase_conversation` |
-| 5 | 智能体管理 | `/admin/agent` | `admin/agent/AgentView.vue` | `perm_workcase_agent` |
-| 6 | 日志管理 | `/admin/log` | *(目录)* | `perm_workcase_log` |
-| 6.1 | └ 知识库日志 | `/admin/log/knowledge` | `admin/log/knowledgeLog/KnowledgeLogView.vue` | `perm_workcase_log` |
-| 6.2 | └ 工单日志 | `/admin/log/workcase` | `admin/log/workcaseLog/WorkcaseLogView.vue` | `perm_workcase_log` |
-| 6.3 | └ 系统日志 | `/admin/log/system` | `admin/log/systemLog/SystemLogView.vue` | `perm_workcase_log` |
-
-### 权限配置
-```sql
-- 管理后台入口权限
-PERM-0621: perm_workcase_admin (workcase:admin:view)
-
-- 内部功能权限
-PERM-0622: perm_workcase_overview (workcase:overview:view)
-PERM-0623: perm_workcase_knowledge (workcase:knowledge:view)
-PERM-0624: perm_workcase_tickets (workcase:tickets:view)
-PERM-0625: perm_workcase_conversation (workcase:conversation:view)
-PERM-0626: perm_workcase_agent (workcase:agent:view)
-PERM-0627: perm_workcase_log (workcase:log:view)
-```
-
---
-
-## 路由过滤规则
-
-### 外层主 Sidebar (platform/SidebarLayout)
-显示所有 `service='platform'` 且 `layout='SidebarLayout'` 的视图：
- 用户应用入口（普通路由和iframe）
- 管理后台入口（iframe类型）
-
-### 内层 SubSidebarLayout
-各服务内部，显示 `layout='SubSidebarLayout'` 且 `url.startsWith('/admin')` 的视图：
-
-#### Platform AdminSidebar
-```typescript
-service === 'platform' && 
-layout === 'SubSidebarLayout' && 
-url.startsWith('/admin')
-```
-
-#### Bidding AdminSidebar
-```typescript
-service === 'bidding' && 
-layout === 'SubSidebarLayout' && 
-url.startsWith('/admin')
-```
-
-#### Workcase AdminSidebar
-```typescript
-service === 'workcase' && 
-layout === 'SubSidebarLayout' && 
-url.startsWith('/admin')
-```
-
---
-
-## 数据库表关系
-
-### 视图类型说明
-| type | view_type | 说明 | 示例 |
-|------|-----------|------|------|
-| 1 | route | 普通路由视图 | 数据概览、用户管理 |
-| 1 | iframe | iframe嵌入视图 | 管理后台入口、Dify编排 |
-| 0 | route | 目录（不可点击） | 日志管理 |
-| 3 | route | 默认首页（隐藏） | 智能客服首页 |
-
-### 视图权限关联
-每个视图通过 `tb_sys_view_permission` 表关联到对应权限：
- 一个视图可以关联多个权限（AND 逻辑）
- 用户需要拥有所有关联权限才能访问该视图
-
-### 角色权限继承
- **超级管理员**: 自动拥有所有权限
- **系统管理员**: 拥有所有 module 的管理权限（除删除外）
- **普通用户**: 基础查看权限 + 平台基础菜单访问
- **访客**: 仅查看权限 + 部分平台菜单访问
-
---
-
-## 前端实现注意事项
-
-### 1. Layout 组件
- **SidebarLayout**: 外层主侧边栏（platform 主界面）
- **SubSidebarLayout**: 内层管理侧边栏（各管理后台内部）
- **BlankLayout**: 空白布局（如智能客服首页）
-
-### 2. iframe 嵌套
- 外层 platform 的 iframe 菜单 → 加载各服务的管理后台
- 各服务内部使用 SubSidebarLayout 渲染二级菜单
- iframe_url 必须正确指向实际服务地址
-
-### 3. 路由配置
-所有 `/admin/*` 路径统一用于管理后台：
- platform: `/admin/overview`, `/admin/user` 等
- bidding: `/admin/*` (待定义)
- workcase: `/admin/overview`, `/admin/knowledge` 等
-
-### 4. 权限验证
-前端需要根据 `loginDomain.userViews` 动态渲染菜单：
- 检查 `layout` 字段匹配当前布局
- 检查 `service` 字段匹配当前服务
- 检查用户是否拥有关联的权限
-
---
-
-## 迁移说明
-
-如果从旧的单层架构迁移到三层架构：
-
-1. **视图迁移**
-   - 将原 platform 的管理视图改为 `layout='SubSidebarLayout'`
-   - URL 统一改为 `/admin/*` 格式
-   - 在 platform 主侧边栏添加 iframe 入口
-
-2. **权限迁移**
-   - 保留原有权限定义
-   - 新增管理后台入口权限（如 `perm_platform_admin`）
-   - 更新视图权限关联
-
-3. **前端组件**
-   - 创建 SubSidebarLayout 组件（参考 workcase 实现）
-   - 更新 platform 路由配置支持 `/admin/*` 路径
-   - 配置 iframe 路由指向各服务管理后台
-
---
-
-## 总结
-
-这个三层架构设计实现了：
- ✅ **统一入口**: 所有管理后台统一在 platform 主侧边栏
- ✅ **独立管理**: 各服务管理后台相互独立，便于维护
- ✅ **权限细分**: 入口权限 + 功能权限双重控制
- ✅ **灵活扩展**: 新增服务只需添加 iframe 入口和内部视图
- ✅ **用户体验**: 统一的导航风格，清晰的层级结构
--- a/urbanLifelineServ/.bin/database/postgres/sql/workcase_admin_routes_summary.md
+++ b/urbanLifelineServ/.bin/database/postgres/sql/workcase_admin_routes_summary.md
@@ -1,130 +0,0 @@
-# Workcase 管理端路由配置总结
-
-## 已配置的管理端视图
-
-### 1. 数据概览 (Overview)
- **view_id**: `view_workcase_admin_overview`
- **URL**: `/admin/overview`
- **组件**: `admin/overview/OverviewView.vue`
- **图标**: DataLine
- **权限**: `perm_workcase_overview` (workcase:overview:view)
- **描述**: 泰豪小电数据概览
-
-### 2. 知识库管理 (Knowledge)
- **view_id**: `view_workcase_admin_knowledge`
- **URL**: `/admin/knowledge`
- **组件**: `admin/knowledge/KnowLedgeView.vue`
- **图标**: Document
- **权限**: `perm_workcase_knowledge` (workcase:knowledge:view)
- **描述**: 知识库文档管理
-
-### 3. 工单管理 (Tickets)
- **view_id**: `view_workcase_admin_tickets`
- **URL**: `/admin/workcase`
- **组件**: `admin/workcase/WorkcaseView.vue`
- **图标**: Tickets
- **权限**: `perm_workcase_tickets` (workcase:tickets:view)
- **描述**: 客服工单管理
-
-### 4. 对话数据 (Conversation)
- **view_id**: `view_workcase_admin_conversation`
- **URL**: `/admin/customerChat`
- **组件**: `admin/customerChat/CustomerChatView.vue`
- **图标**: ChatDotRound
- **权限**: `perm_workcase_conversation` (workcase:conversation:view)
- **描述**: 客户对话数据管理
-
-### 5. 智能体管理 (Agent)
- **view_id**: `view_workcase_admin_agent`
- **URL**: `/admin/agent`
- **组件**: `admin/agent/AgentView.vue`
- **图标**: Service
- **权限**: `perm_workcase_agent` (workcase:agent:view)
- **描述**: 智能体配置管理
-
-### 6. 日志管理 (Logs)
-#### 6.1 日志管理目录
- **view_id**: `view_workcase_admin_log`
- **URL**: `/admin/log`
- **组件**: NULL (目录类型)
- **图标**: List
- **type**: 0 (目录)
- **权限**: `perm_workcase_log` (workcase:log:view)
- **描述**: 日志管理目录
-
-#### 6.2 知识库日志
- **view_id**: `view_workcase_admin_log_knowledge`
- **parent_id**: `view_workcase_admin_log`
- **URL**: `/admin/log/knowledge`
- **组件**: `admin/log/knowledgeLog/KnowledgeLogView.vue`
- **图标**: Document
- **权限**: `perm_workcase_log` (workcase:log:view)
- **描述**: 知识库操作日志
-
-#### 6.3 工单日志
- **view_id**: `view_workcase_admin_log_workcase`
- **parent_id**: `view_workcase_admin_log`
- **URL**: `/admin/log/workcase`
- **组件**: `admin/log/workcaseLog/WorkcaseLogView.vue`
- **图标**: Tickets
- **权限**: `perm_workcase_log` (workcase:log:view)
- **描述**: 工单操作日志
-
-#### 6.4 系统日志
- **view_id**: `view_workcase_admin_log_system`
- **parent_id**: `view_workcase_admin_log`
- **URL**: `/admin/log/system`
- **组件**: `admin/log/systemLog/SystemLogView.vue`
- **图标**: Setting
- **权限**: `perm_workcase_log` (workcase:log:view)
- **描述**: 系统运行日志
-
-## 权限配置
-
-### 新增权限
-1. **PERM-0601**: `perm_workcase_overview` - 数据概览
-2. **PERM-0602**: `perm_workcase_knowledge` - 知识库管理
-3. **PERM-0603**: `perm_workcase_tickets` - 工单管理
-4. **PERM-0604**: `perm_workcase_conversation` - 对话数据
-5. **PERM-0605**: `perm_workcase_agent` - 智能体管理
-6. **PERM-0606**: `perm_workcase_log` - 日志管理
-
-### 视图权限关联
- VP-W101 ~ VP-W105: 管理端主功能视图
- VP-W106 ~ VP-W109: 日志管理视图（含父级和3个子级）
-
-## 布局配置
- **Layout**: `SubSidebarLayout`
- **Service**: `workcase`
- **Type**: 1 (菜单项) / 0 (目录)
- **View Type**: `route`
-
-## Order Number 排序
- 110: 数据概览
- 120: 知识库管理
- 130: 工单管理
- 140: 对话数据
- 150: 智能体管理
- 160: 日志管理（父级）
-  - 161: 知识库日志
-  - 162: 工单日志
-  - 163: 系统日志
-
-## 路由过滤规则
-在 `SubSidebarLayout.vue` 的 `loadMenuFromStorage()` 中：
-```typescript
-const sidebarViews = userViews.filter((view: any) => 
-    view.layout === 'SidebarLayout' &&  // 使用 SidebarLayout 布局
-    !view.parentId &&                    // 顶级菜单
-    view.type === 1 &&                   // 菜单类型
-    view.service === 'workcase' &&       // workcase 服务
-    view.url?.startsWith('/admin')       // admin 路由
-)
-```
-
-## 注意事项
-1. 所有管理端路由都以 `/admin/` 开头
-2. 日志管理使用父子级结构（type=0 的目录 + type=1 的子菜单）
-3. 所有视图都使用 `SubSidebarLayout` 布局
-4. 权限都归属于 `module_workcase` 模块
-5. 超级管理员和系统管理员默认拥有所有 workcase 管理端权限