wangys/urbanLifeline
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

temp

Browse Source
This commit is contained in:
wangys
2025-12-02 13:21:18 +08:00
parent fab8c13cb3
commit ee6dd64f98
192 changed files with 25783 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

599
docs/数据库表结构速查.md Normal file
View File

@@ -0,0 +1,599 @@
# 数据库表结构速查手册
## 快速导航
- [系统基础模块 (sys)](#系统基础模块-sys)
- [文件管理模块 (file)](#文件管理模块-file)
- [消息通知模块 (message)](#消息通知模块-message)
- [日志模块 (log)](#日志模块-log)
- [配置管理模块 (config)](#配置管理模块-config)
- [知识库管理模块 (knowledge)](#知识库管理模块-knowledge)
- [招投标智能体模块 (bidding)](#招投标智能体模块-bidding)
- [智能客服系统模块 (customer_service)](#智能客服系统模块-customerservice)
- [智能体管理模块 (agent)](#智能体管理模块-agent)
---
## 系统基础模块 (sys)
### 核心表结构
| 表名 | 说明 | 主键 | 核心字段 |
|------|------|------|----------|
| `tb_sys_user` | 用户表 | user_id | email, phone, wechat_id, status |
| `tb_sys_user_info` | 用户信息表 | user_id | avatar, full_name, gender, level |
| `tb_sys_dept` | 部门表 | dept_id | name, parent_id, dept_path |
| `tb_sys_role` | 角色表 | role_id | name, scope, owner_dept_id |
| `tb_sys_permission` | 权限表 | permission_id | name, code, module_id |
| `tb_sys_user_role` | 用户角色关联表 | (user_id, role_id) | - |
| `tb_sys_role_permission` | 角色权限关联表 | (role_id, permission_id) | - |
| `tb_sys_view` | 视图/菜单表 | view_id | name, url, component, type |
| `tb_sys_module` | 模块表 | module_id | name, description |
| `tb_sys_acl` | 对象级权限表 | acl_id | object_type, object_id, principal_type, permission |
| `tb_sys_acl_policy` | ACL策略表 | policy_id | object_type, edit_hierarchy_rule, view_hierarchy_rule |
| `tb_sys_login_log` | 登录日志表 | optsn | user_id, ip_address, login_time, status |
| `tb_sys_user_dept` | 用户部门关联表 | (user_id, dept_id) | is_primary, position |
### 权限模型
```
用户 (tb_sys_user)
├─ 用户角色 (tb_sys_user_role)
│ └─ 角色 (tb_sys_role)
│ ├─ 角色权限 (tb_sys_role_permission)
│ │ └─ 权限 (tb_sys_permission)
│ │ └─ 模块 (tb_sys_module)
│ └─ 视图权限 (tb_sys_view_permission)
│ └─ 视图 (tb_sys_view)
└─ 对象权限 (tb_sys_acl)
└─ ACL策略 (tb_sys_acl_policy)
```
### 常用查询
```sql
-- 查询用户所有权限
SELECT p.code, p.name
FROM sys.tb_sys_user_role ur
JOIN sys.tb_sys_role_permission rp ON ur.role_id = rp.role_id
JOIN sys.tb_sys_permission p ON rp.permission_id = p.permission_id
WHERE ur.user_id = 'USER_ID' AND ur.deleted = false;
-- 查询部门树
WITH RECURSIVE dept_tree AS (
SELECT *, 1 AS level FROM sys.tb_sys_dept WHERE parent_id IS NULL
UNION ALL
SELECT d.*, dt.level + 1
FROM sys.tb_sys_dept d
JOIN dept_tree dt ON d.parent_id = dt.dept_id
)
SELECT * FROM dept_tree ORDER BY level, dept_id;
```
---
## 文件管理模块 (file)
### 核心表结构
| 表名 | 说明 | 主键 | 核心字段 |
|------|------|------|----------|
| `tb_sys_file` | 文件表 | file_id | name, path, size, type, storage_type, url |
| `tb_file_relation` | 文件关联表 | relation_id | file_id, object_type, object_id, relation_type |
### 文件类型
- `storage_type`: local(本地存储) / oss(对象存储) / ftp / sftp
- `relation_type`: attachment(附件) / avatar(头像) / banner(横幅)
### 常用查询
```sql
-- 查询对象的所有附件
SELECT f.*
FROM file.tb_sys_file f
JOIN file.tb_file_relation fr ON f.file_id = fr.file_id
WHERE fr.object_type = 'bidding_project'
AND fr.object_id = 'PROJECT_ID'
AND fr.deleted = false;
```
---
## 消息通知模块 (message)
### 核心表结构
| 表名 | 说明 | 主键 | 核心字段 |
|------|------|------|----------|
| `tb_message` | 消息表 | message_id | title, content, type, status |
| `tb_message_range` | 消息发送范围表 | optsn | message_id, target_type, target_id, channel |
| `tb_message_receiver` | 用户消息接收表 | optsn | message_id, user_id, status, read_time |
| `tb_message_channel` | 消息渠道配置表 | channel_id | channel_code, channel_name, status |
| `tb_message_template` | 消息模板表 | template_id | template_code, title_template, content_template |
### 消息发送流程
```
创建消息 (tb_message)
↓
定义发送范围 (tb_message_range)
├─ target_type: user(指定用户) / dept(部门) / role(角色) / all(全员)
├─ channel: app / sms / email / wechat
↓
生成接收记录 (tb_message_receiver)
└─ status: unread → read → handled / deleted
```
### 常用查询
```sql
-- 查询用户未读消息
SELECT m.*, mr.create_time AS receive_time
FROM message.tb_message m
JOIN message.tb_message_receiver mr ON m.message_id = mr.message_id
WHERE mr.user_id = 'USER_ID'
AND mr.status = 'unread'
AND mr.deleted = false
ORDER BY mr.create_time DESC;
```
---
## 日志模块 (log)
### 核心表结构
| 表名 | 说明 | 主键 | 核心字段 |
|------|------|------|----------|
| `tb_sys_log` | 系统日志表 | log_id | type, level, module, message, data, trace_id |
### 日志级别
- `level`: debug / info / warn / error / fatal
- `type`: system / audit / security / business / api
### 常用查询
```sql
-- 查询错误日志
SELECT * FROM log.tb_sys_log
WHERE level IN ('error', 'fatal')
AND create_time > now() - interval '24 hours'
ORDER BY create_time DESC;
-- 链路追踪
SELECT * FROM log.tb_sys_log
WHERE trace_id = 'TRACE_ID'
ORDER BY create_time;
```
---
## 配置管理模块 (config)
### 核心表结构
| 表名 | 说明 | 主键 | 核心字段 |
|------|------|------|----------|
| `tb_sys_config` | 系统配置表 | config_id | key, name, value, config_type, render_type |
### 配置类型
- `config_type`: String / Integer / Boolean / Float / Double
- `render_type`: select / input / textarea / checkbox / radio / switch
### 常用查询
```sql
-- 按模块查询配置
SELECT * FROM config.tb_sys_config
WHERE module_id = 'MODULE_ID' AND deleted = false
ORDER BY order_num;
```
---
## 知识库管理模块 (knowledge)
### 核心表结构
| 表名 | 说明 | 主键 | 核心字段 |
|------|------|------|----------|
| `tb_knowledge_base` | 知识库表 | kb_id | name, kb_type, access_level, version |
| `tb_knowledge_document` | 知识文档表 | doc_id | kb_id, title, doc_type, category, embedding_status |
| `tb_knowledge_chunk` | 文档片段表 | chunk_id | doc_id, kb_id, content, embedding |
| `tb_knowledge_access_log` | 知识访问日志表 | log_id | kb_id, doc_id, user_id, access_type |
### 知识库类型
- `kb_type`: bidding(招投标) / customer_service(客服) / internal(内部协同)
- `access_level`: public(公开) / private(私有) / internal(内部)
- `embedding_status`: pending(待处理) / processing(处理中) / completed(完成) / failed(失败)
### RAG检索流程
```
用户查询
↓
向量化查询文本
↓
在 tb_knowledge_chunk 中进行向量检索 (embedding)
↓
获取相关文档片段
↓
关联 tb_knowledge_document 获取完整文档信息
↓
返回结果 + 记录访问日志
```
### 常用查询
```sql
-- 查询知识库文档
SELECT d.*, kb.name AS kb_name
FROM knowledge.tb_knowledge_document d
JOIN knowledge.tb_knowledge_base kb ON d.kb_id = kb.kb_id
WHERE d.kb_id = 'KB_ID'
AND d.embedding_status = 'completed'
AND d.deleted = false;
-- 向量检索（需要pgvector扩展）
-- SELECT chunk_id, content,
-- 1 - (embedding <=> '[查询向量]'::vector) AS similarity
-- FROM knowledge.tb_knowledge_chunk
-- WHERE kb_id = 'KB_ID'
-- ORDER BY embedding <=> '[查询向量]'::vector
-- LIMIT 10;
```
---
## 招投标智能体模块 (bidding)
### 核心表结构
| 表名 | 说明 | 主键 | 核心字段 |
|------|------|------|----------|
| `tb_bidding_project` | 招标项目表 | project_id | project_no, project_name, project_status, deadline |
| `tb_bidding_document` | 招标文件表 | doc_id | project_id, doc_type, parse_status, parse_result |
| `tb_bidding_requirement` | 要素提取表 | req_id | project_id, req_category, is_veto, compliance_status |
| `tb_bid_response` | 投标文件生成表 | response_id | project_id, response_type, generation_status |
| `tb_bidding_scoring_rule` | 评分规则表 | rule_id | project_id, rule_category, max_score, our_score |
| `tb_bidding_process` | 流程节点表 | process_id | project_id, node_type, node_status |
| `tb_bid_template` | 投标模板表 | template_id | template_name, template_type, usage_count |
### 项目生命周期
```
collecting(收集中)
↓
analyzing(分析中) - 智能解读招标文件
↓
preparing(准备投标) - 生成投标文件
↓
submitted(已提交)
↓
opened(已开标)
↓
won(中标) / lost(未中标) / abandoned(放弃)
```
### 要素类别
- `req_category`:
- commercial: 商务要素
- technical: 技术参数
- veto: 否决项 ⚠️
- qualification: 资质要求
- delivery: 交付要求
- payment: 付款条件
- scoring: 评分标准
### 常用查询
```sql
-- 查询项目的所有否决项
SELECT * FROM bidding.tb_bidding_requirement
WHERE project_id = 'PROJECT_ID'
AND is_veto = true
AND deleted = false;
-- 查询项目评分预估
SELECT
rule_category,
SUM(max_score) AS total_max_score,
SUM(our_score) AS total_our_score,
ROUND(SUM(our_score) / SUM(max_score) * 100, 2) AS score_percentage
FROM bidding.tb_bidding_scoring_rule
WHERE project_id = 'PROJECT_ID' AND deleted = false
GROUP BY rule_category;
```
---
## 智能客服系统模块 (customer_service)
### 核心表结构
| 表名 | 说明 | 主键 | 核心字段 |
|------|------|------|----------|
| `tb_customer` | 客户信息表 | customer_id | customer_name, phone, wechat_openid, customer_level |
| `tb_conversation` | 会话表 | conversation_id | customer_id, conversation_type, agent_id, satisfaction_rating |
| `tb_conversation_message` | 会话消息表 | message_id | conversation_id, sender_type, content, is_ai_generated |
| `tb_ticket` | 工单表 | ticket_id | ticket_no, customer_id, ticket_type, ticket_status, sla_deadline |
| `tb_ticket_log` | 工单处理记录表 | log_id | ticket_id, action_type, action_content |
| `tb_faq` | FAQ表 | faq_id | category, question, answer, hit_count |
| `tb_service_evaluation` | 客服评价表 | evaluation_id | customer_id, evaluation_type, rating |
| `tb_crm_config` | CRM集成配置表 | config_id | crm_system, api_endpoint, sync_enabled |
### 会话流程
```
客户发起咨询
↓
创建会话 (tb_conversation)
├─ conversation_type: ai(AI客服) / human(人工) / transfer(转接)
↓
消息交互 (tb_conversation_message)
├─ sender_type: customer / agent / system
├─ is_ai_generated: true/false
├─ kb_references: [知识库文档ID]
↓
智能工单生成 (tb_ticket)
├─ ticket_source: ai / manual / system
↓
满意度评价 (tb_service_evaluation / tb_conversation)
```
### 工单状态
- `ticket_status`:
- pending: 待处理
- processing: 处理中
- resolved: 已解决
- closed: 已关闭
- cancelled: 已取消
### 常用查询
```sql
-- 查询客户的活跃会话
SELECT * FROM customer_service.tb_conversation
WHERE customer_id = 'CUSTOMER_ID'
AND conversation_status = 'active'
AND deleted = false;
-- 查询逾期工单
SELECT * FROM customer_service.tb_ticket
WHERE is_overdue = true
AND ticket_status IN ('pending', 'processing')
AND deleted = false
ORDER BY sla_deadline;
-- 查询AI回答质量
SELECT
DATE(create_time) AS stat_date,
AVG(confidence_score) AS avg_confidence,
COUNT(*) FILTER (WHERE confidence_score > 0.8) AS high_confidence_count,
COUNT(*) AS total_count
FROM customer_service.tb_conversation_message
WHERE is_ai_generated = true
AND deleted = false
GROUP BY DATE(create_time);
```
---
## 智能体管理模块 (agent)
### 核心表结构
| 表名 | 说明 | 主键 | 核心字段 |
|------|------|------|----------|
| `tb_agent` | 智能体定义表 | agent_id | agent_code, agent_name, agent_type, model_config |
| `tb_agent_session` | 智能体会话表 | session_id | agent_id, user_id, session_status, token_usage |
| `tb_agent_message` | 智能体消息表 | message_id | session_id, role, content, function_call |
| `tb_agent_tool` | 智能体工具表 | tool_id | tool_code, tool_type, function_schema, api_endpoint |
| `tb_api_integration` | API集成表 | integration_id | integration_name, base_url, auth_config |
| `tb_api_call_log` | API调用日志表 | log_id | integration_id, endpoint, response_status, duration_ms |
| `tb_agent_metrics` | 智能体监控指标表 | metric_id | agent_id, metric_date, total_sessions, total_tokens |
| `tb_agent_error_log` | 智能体异常日志表 | log_id | agent_id, error_type, error_message, severity |
| `tb_agent_rating` | 智能体评价表 | rating_id | agent_id, rating, feedback |
### 智能体类型
- `agent_type`:
- bidding: 招投标智能体
- customer_service: 客服智能体
- knowledge_assistant: 知识助手
- custom: 自定义智能体
### 工具类型
- `tool_type`:
- api: API调用
- function: 函数
- plugin: 插件
- integration: 集成
### 会话流程
```
用户请求
↓
创建会话 (tb_agent_session)
↓
消息交互 (tb_agent_message)
├─ role: user / assistant / system / function
├─ function_call: 工具调用
↓
工具执行 (tb_agent_tool)
├─ API调用记录 (tb_api_call_log)
↓
记录监控指标 (tb_agent_metrics)
├─ 错误记录 (tb_agent_error_log)
↓
用户评价 (tb_agent_rating)
```
### 常用查询
```sql
-- 查询智能体使用统计
SELECT * FROM agent.v_agent_usage_stats
WHERE agent_id = 'AGENT_ID';
-- 查询API健康状态
SELECT
integration_name,
health_status,
last_health_check,
EXTRACT(EPOCH FROM (now() - last_health_check))/60 AS minutes_since_check
FROM agent.tb_api_integration
WHERE deleted = false
ORDER BY health_status, last_health_check;
-- 查询智能体错误率
SELECT
a.agent_name,
COUNT(*) FILTER (WHERE e.severity = 'critical') AS critical_errors,
COUNT(*) FILTER (WHERE e.severity = 'error') AS errors,
COUNT(*) AS total_errors
FROM agent.tb_agent a
LEFT JOIN agent.tb_agent_error_log e ON a.agent_id = e.agent_id
WHERE e.create_time > now() - interval '24 hours'
GROUP BY a.agent_id, a.agent_name;
```
---
## 数据字典常用字段说明
### 通用字段
所有表都包含以下标准字段：
| 字段 | 类型 | 说明 |
|------|------|------|
| `optsn` | VARCHAR(50) | 流水号（唯一标识） |
| `xxx_id` | VARCHAR(50) | 主键ID |
| `dept_path` | VARCHAR(255) | 部门全路径（多租户隔离） |
| `creator` | VARCHAR(50) | 创建者ID |
| `updater` | VARCHAR(50) | 更新者ID |
| `create_time` | timestamptz | 创建时间（带时区） |
| `update_time` | timestamptz | 更新时间（触发器自动更新） |
| `delete_time` | timestamptz | 删除时间 |
| `deleted` | BOOLEAN | 软删除标记 |
### 时间戳说明
- 使用 `timestamptz` 类型（带时区的时间戳）
- 自动记录创建时间
- 更新时间由触发器自动维护
- 支持软删除（保留 delete_time）
### 部门路径（dept_path）
格式：`/1/2/3/`
- 用于多租户数据隔离
- 支持 LIKE 递归查询
- 示例查询：`WHERE dept_path LIKE '/1/2/%'`
---
## 视图速查
| 视图名 | Schema | 说明 |
|--------|--------|------|
| `v_user_full_info` | sys | 用户完整信息（含用户信息表） |
| `v_user_role_permission` | sys | 用户角色权限（含模块） |
| `v_user_full_permissions` | sys | 用户完整权限（含ACL） |
| `v_agent_usage_stats` | agent | 智能体使用统计 |
| `v_agent_realtime_status` | agent | 智能体实时状态 |
| `v_ticket_stats` | customer_service | 工单统计 |
| `v_ticket_efficiency` | customer_service | 工单处理效率 |
| `v_project_stats` | bidding | 招投标项目统计 |
---
## 函数速查
| 函数名 | Schema | 说明 |
|--------|--------|------|
| `update_modified_column()` | public | 自动更新update_time触发器函数 |
| `audit_trigger_func()` | public | 审计日志触发器函数 |
| `archive_old_logs()` | public | 归档旧日志数据 |
| `archive_api_logs()` | agent | 归档API调用日志 |
| `check_table_bloat()` | public | 检查表膨胀情况 |
| `create_update_triggers()` | public | 批量创建更新触发器 |
---
## 索引策略
### 主要索引类型
1. **B-Tree索引**（默认）：主键、外键、常规查询字段
2. **GIN索引**：JSONB字段、数组字段、全文搜索
3. **部分索引**：带WHERE条件的索引（如 `WHERE deleted = false`）
4. **表达式索引**：函数索引（如 `lower(email)`）
### 关键索引示例
```sql
-- 部分索引（减少索引大小）
CREATE INDEX idx_xxx ON table_name(column) WHERE deleted = false;
-- GIN索引（数组查询）
CREATE INDEX idx_xxx ON table_name USING gin(array_column);
-- 全文搜索索引
CREATE INDEX idx_xxx ON table_name USING gin(text_column gin_trgm_ops);
-- 表达式索引
CREATE INDEX idx_xxx ON table_name(lower(email));
```
---
## 性能优化建议
### 查询优化
1. **使用索引**：WHERE、JOIN、ORDER BY字段都要有索引
2. **避免SELECT ***：只查询需要的字段
3. **使用LIMIT**：分页查询限制返回行数
4. **使用EXPLAIN**：分析查询计划
### 批量操作
```sql
-- 批量插入（使用COPY或批量INSERT）
COPY table_name FROM '/path/to/file.csv' WITH CSV;
-- 批量更新（使用UPDATE...FROM）
UPDATE table_name t
SET column = data.value
FROM (VALUES (1, 'a'), (2, 'b')) AS data(id, value)
WHERE t.id = data.id;
```
### 定期维护
```sql
-- 分析表（更新统计信息）
ANALYZE table_name;
-- 清理和分析
VACUUM ANALYZE table_name;
-- 重建索引
REINDEX TABLE table_name;
```
---
**版本**: 1.0
**更新时间**: 2024-12-02

511
docs/数据库设计交付总结.md Normal file
View File

@@ -0,0 +1,511 @@
# 泰豪电源AI数智化平台 - 数据库设计交付总结
## 📋 交付概览
基于`功能结构.xml`中定义的系统架构，完成了泰豪电源AI数智化平台的完整数据库设计，覆盖"一个底座、多种智能体"的核心理念和四大业务模块。
---
## 📦 交付内容
### 1. SQL脚本文件
所有文件位于：`urbanLifelineServ\.bin\database\postgres\sql\`
| 文件名 | 说明 | 表数量 |
|--------|------|--------|
| `createTablePermission.sql` | 系统权限模块（现有优化） | 11张 |
| `createTableUser.sql` | 用户管理模块（现有优化） | 3张 |
| `createTableFile.sql` | 文件管理模块（现有） | 1张 |
| `createTableMessage.sql` | 消息通知模块（现有） | 4张 |
| `createTableLog.sql` | 日志模块（现有） | 1张 |
| `createTableConfig.sql` | 配置管理模块（现有） | 1张 |
| **`createTableKnowledge.sql`** | ✨ **知识库管理模块（新建）** | **4张** |
| **`createTableBidding.sql`** | ✨ **招投标智能体业务模块（新建）** | **8张** |
| **`createTableCustomerService.sql`** | ✨ **智能客服系统业务模块（新建）** | **9张** |
| **`createTableAgent.sql`** | ✨ **智能体管理模块（新建）** | **11张** |
| **`createTableAll.sql`** | ✨ **完整初始化脚本（新建）** | - |
| **`optimizations.sql`** | ✨ **数据库优化补丁（新建）** | - |
**总计：53张核心业务表**
### 2. 文档资料
所有文档位于：`docs\`
| 文件名 | 说明 |
|--------|------|
| **`数据库设计文档.md`** | 完整的数据库设计说明文档（23000+字） |
| **`数据库表结构速查.md`** | 表结构快速参考手册（含常用查询示例） |
| **`数据库设计交付总结.md`** | 本文档 |
---
## 🎯 核心设计亮点
### 1. 模块化架构设计
采用9个Schema实现业务逻辑隔离：
```
sys ← 系统基础（用户、权限、部门）
file ← 文件管理
message ← 消息通知
log ← 日志审计
config ← 系统配置
knowledge ← 知识库管理（支持RAG检索）
bidding ← 招投标智能体业务
customer_service ← 智能客服系统业务
agent ← 智能体管理和平台基础设施
```
### 2. 权限体系设计
**RBAC + ACL混合模型**
- **RBAC（基于角色的访问控制）**：
- 支持全局角色和部门私有角色
- 角色-权限-模块三层结构
- 视图/菜单权限独立管理
- **ACL（访问控制列表）**：
- 对象级细粒度权限控制
- 支持任意对象类型（文章、文件、课程等）
- 权限位设计（读/写/执行）
- 支持显式拒绝和权限继承
### 3. 多租户支持
- **部门路径隔离**（`dept_path`字段）：格式 `/1/2/3/`
- **行级安全策略**（RLS）：基于用户部门自动过滤数据
- **作用域控制**：角色和权限的作用域管理
### 4. 知识库智能管理
**支持RAG（检索增强生成）流程：**
```
文档上传 → 智能分类 → AI摘要 → 关键词提取 → 文档切片 → 向量化 → 存储
↓ ↓
tb_knowledge_document tb_knowledge_chunk
(支持向量检索)
```
**特性：**
- 多类型知识库（招投标/客服/内部协同）
- 版本管理和历史追溯
- 向量化状态跟踪
- 访问日志记录
### 5. 招投标全流程管理
**完整业务流程覆盖：**
```
项目创建 → 文件采集 → 智能解读 → 要素提取 → 评分分析
↓ ↓
流程跟踪 ← 投标提交 ← 文件审核 ← 投标文件生成 ← 模板管理
```
**核心功能：**
- **智能要素提取**：7大类要素（商务/技术/否决项/资质/交付/付款/评分）
- **AI文件生成**：支持技术标/商务标/综合标
- **评分规则分析**：自动解析评分标准，预估得分
- **流程节点管理**：完整的项目生命周期跟踪
### 6. 智能客服系统
**全渠道客服支持：**
```
微信小程序 → AI问答 → 知识库检索 → 工单生成 → CRM同步
↓ ↓ ↓ ↓
客户管理 会话记录 工单处理 满意度评价
```
**特性：**
- **双终端知识库**：客户咨询知识库（外部）+ 内部资料知识库（内部）
- **智能会话管理**：AI/人工/转接会话类型，情感分析，意图识别
- **工单智能处理**：AI自动生成工单，SLA超时预警，CRM双向同步
- **评价体系**：多维度评价（准确性、速度、友好度等）
### 7. 智能体管理平台
**智能体广场 + 工具集成 + 运维监控：**
```
智能体定义 → 工具配置 → API集成 → 会话管理 → 监控运维 → 评价反馈
↓ ↓ ↓ ↓ ↓
多模型支持 Function 健康检查 Token统计 错误追踪
```
**特性：**
- **智能体广场**：发布/评分/分类/标签管理
- **工具生态**：支持API调用、函数、插件、集成
- **监控体系**：实时指标、错误日志、性能分析
- **成本跟踪**：Token使用量、API调用费用统计
---
## 📊 数据库架构统计
### 表结构统计
| Schema | 表数量 | 主要功能 |
|--------|--------|----------|
| sys | 13 | 用户、角色、权限、部门、ACL |
| file | 2 | 文件管理、文件关联 |
| message | 5 | 消息、发送范围、接收记录、渠道、模板 |
| log | 1 | 系统日志 |
| config | 1 | 系统配置 |
| knowledge | 4 | 知识库、文档、片段、访问日志 |
| bidding | 8 | 项目、文件、要素、投标、评分、流程、模板 |
| customer_service | 9 | 客户、会话、消息、工单、FAQ、评价、CRM |
| agent | 11 | 智能体、会话、消息、工具、API、监控、错误 |
| **总计** | **54** | - |
### 索引策略
- **B-Tree索引**：100+ 个（主键、外键、常规查询）
- **GIN索引**：20+ 个（JSONB、数组、全文搜索）
- **部分索引**：50+ 个（WHERE deleted = false）
- **表达式索引**：5+ 个（函数索引）
### 视图和函数
- **业务视图**：8个（权限视图、统计视图）
- **触发器函数**：2个（自动更新时间、审计日志）
- **业务函数**：4个（数据归档、性能监控）
---
## 🔧 技术特性
### 1. 数据类型使用
- **timestamptz**：全部时间字段（带时区支持）
- **JSONB**：配置、元数据、扩展字段
- **数组（TEXT[]）**：标签、关键词、ID列表
- **DECIMAL**：金额、评分（精确计算）
- **vector**：向量嵌入（需pgvector扩展，可选）
### 2. 软删除机制
所有业务表支持软删除：
- `deleted` 字段：BOOLEAN类型，默认false
- `delete_time` 字段：删除时间戳
- 索引优化：`WHERE deleted = false`
### 3. 审计追踪
- **通用字段**：creator、updater、create_time、update_time
- **自动触发器**：update_time自动更新
- **审计日志**：可选的审计触发器（记录所有变更）
- **链路追踪**：trace_id、span_id支持分布式追踪
### 4. 性能优化
- **分区表设计**：日志表、指标表建议按时间分区
- **物化视图**：权限视图可物化提升性能
- **数据归档**：提供自动归档函数
- **表膨胀监控**：check_table_bloat()函数
---
## 📈 业务价值
### 1. 支撑功能结构.xml定义的四大业务模块
✅ **资料管理智能化** → knowledge模块
✅ **招投标自动化** → bidding模块
✅ **售后客服智能化** → customer_service模块
✅ **企业内部知识协同** → knowledge + agent模块
### 2. 实现"一个底座、多种智能体"
- **统一的智能体管理平台**（agent模块）
- **共享的知识库体系**（knowledge模块）
- **统一的权限和用户管理**（sys模块）
- **统一的文件和消息服务**（file、message模块）
### 3. 可扩展性设计
- **新增智能体类型**：在agent.tb_agent中添加新的agent_type
- **新增业务模块**：创建新的Schema和表
- **集成外部系统**：通过API集成表和CRM配置表
- **自定义权限**：通过ACL表实现任意对象的权限控制
---
## 🚀 部署指南
### 快速部署
```bash
# 进入SQL脚本目录
cd urbanLifelineServ\.bin\database\postgres\sql
# 1. 创建数据库
createdb urbanlifeline
# 2. 执行完整初始化脚本（推荐）
psql -d urbanlifeline -f createTableAll.sql
# 或者手动按顺序执行
psql -d urbanlifeline -f createTablePermission.sql
psql -d urbanlifeline -f createTableUser.sql
psql -d urbanlifeline -f createTableFile.sql
psql -d urbanlifeline -f createTableMessage.sql
psql -d urbanlifeline -f createTableLog.sql
psql -d urbanlifeline -f createTableConfig.sql
psql -d urbanlifeline -f createTableKnowledge.sql
psql -d urbanlifeline -f createTableBidding.sql
psql -d urbanlifeline -f createTableCustomerService.sql
psql -d urbanlifeline -f createTableAgent.sql
# 3. 执行优化补丁（可选）
psql -d urbanlifeline -f optimizations.sql
# 4. 初始化基础数据
psql -d urbanlifeline -f initDataConfig.sql
```
### 依赖扩展
```sql
-- 必需扩展
CREATE EXTENSION IF NOT EXISTS "uuid-ossp"; -- UUID生成
CREATE EXTENSION IF NOT EXISTS "pg_trgm"; -- 全文搜索
CREATE EXTENSION IF NOT EXISTS "btree_gin"; -- GIN索引支持
-- 可选扩展
CREATE EXTENSION IF NOT EXISTS "pgcrypto"; -- 数据加密
CREATE EXTENSION IF NOT EXISTS "vector"; -- 向量检索（需单独安装）
```
---
## 🔍 现有SQL文件的优化建议
### 已实施的优化
✅ **createTableUser.sql**
- 移除登录日志表的password字段（安全性）
- 添加用户部门关联表（多对多关系）
- 添加主部门字段
✅ **createTablePermission.sql**
- 添加角色排序字段
- 添加权限类型字段（操作/数据/菜单权限）
✅ **createTableFile.sql**
- 添加版本管理字段
- 添加分类和标签
- 创建文件关联表（统一文件关联机制）
✅ **createTableMessage.sql**
- 创建消息模板表（支持模板化发送）
✅ **createTableLog.sql**
- 添加链路追踪字段（trace_id、span_id）
### 建议的补充优化
详见：`optimizations.sql`文件
---
## 📚 参考文档
### 1. 数据库设计文档.md
**内容包含：**
- 系统概述和架构设计
- 核心模块详细设计
- 数据库优化建议
- 现有SQL文件修改建议
- 数据安全建议
- 部署和维护建议
**适用场景：**
- 系统架构师了解整体设计
- 开发人员理解业务逻辑
- DBA进行数据库优化
### 2. 数据库表结构速查.md
**内容包含：**
- 所有模块的表结构快速参考
- 常用查询示例
- 视图和函数速查
- 索引策略说明
- 性能优化建议
**适用场景：**
- 日常开发查询表结构
- 编写业务SQL
- 快速定位相关表
### 3. 功能结构.xml
**原始需求文档：**
- 系统目标定义
- 四大业务模块功能划分
- 平台基础设施模块
- Draw.io格式的架构图
---
## ✅ 验证检查清单
### 数据完整性
- [x] 所有表都有主键
- [x] 外键关系正确定义
- [x] 唯一约束合理设置
- [x] 非空约束符合业务逻辑
### 性能优化
- [x] 高频查询字段都有索引
- [x] 外键字段都有索引
- [x] 使用部分索引减少索引大小
- [x] JSONB和数组字段使用GIN索引
### 安全性
- [x] 敏感字段移除或加密
- [x] 软删除机制
- [x] 审计日志支持
- [x] 行级安全策略（可选启用）
### 可维护性
- [x] 表名和字段名规范统一
- [x] 所有表和字段都有注释
- [x] 触发器自动维护update_time
- [x] 提供数据归档函数
### 可扩展性
- [x] Schema分离便于模块扩展
- [x] JSONB字段支持灵活扩展
- [x] 标签和分类字段
- [x] 元数据字段预留
---
## 📊 后续优化方向
### 短期（1-3个月）
1. **向量检索优化**
- 安装pgvector扩展
- 优化embedding索引参数
- 实现混合检索（向量+全文）
2. **监控告警**
- 集成pgBadger日志分析
- 配置慢查询告警
- 设置表膨胀告警
3. **数据初始化**
- 编写初始化数据脚本
- 创建测试数据集
- 准备演示数据
### 中期（3-6个月）
1. **性能优化**
- 分析慢查询并优化
- 实施分区表策略
- 创建物化视图
2. **读写分离**
- 配置主从复制
- 实现读写分离中间件
- 优化读库查询
3. **备份策略**
- 实施全量+增量备份
- 配置WAL归档
- 演练灾难恢复
### 长期（6-12个月）
1. **分布式部署**
- 评估Citus扩展
- 设计分片策略
- 实现水平扩展
2. **多数据中心**
- 配置异地备份
- 实现数据同步
- 制定灾备方案
3. **智能优化**
- 自动索引推荐
- 查询性能自动优化
- 存储自动扩容
---
## 🎓 技术栈总结
### 数据库技术
- **PostgreSQL 14+**：主数据库
- **pgvector**：向量检索（可选）
- **pg_trgm**：全文搜索
- **JSONB**：半结构化数据存储
- **Row Level Security**：行级安全策略
### 设计模式
- **RBAC + ACL**：混合权限模型
- **软删除**：数据安全保护
- **多租户**：部门路径隔离
- **审计追踪**：完整的变更记录
- **事件驱动**：触发器自动化
### 性能优化
- **索引策略**：B-Tree + GIN + 部分索引
- **查询优化**：视图、CTE、窗口函数
- **数据归档**：自动归档函数
- **分区表**：时间序列数据分区
---
## 📞 技术支持
### 问题反馈
如在使用过程中遇到问题，请提供：
1. 问题描述
2. 错误信息
3. 执行的SQL语句
4. PostgreSQL版本
### 文档维护
本文档随数据库设计持续更新：
- **当前版本**：v1.0
- **更新日期**：2024-12-02
- **维护团队**：泰豪电源AI数智化平台开发组
---
## 🎉 交付完成
✅ **50+张核心业务表设计完成**
✅ **12个SQL脚本文件交付**
✅ **3份完整技术文档**
✅ **覆盖4大业务模块**
✅ **支持"一个底座、多种智能体"架构**
**数据库设计已完全就绪，可直接用于项目开发！** 🚀
---
**感谢使用！**

698
docs/数据库设计文档.md Normal file
View File

@@ -0,0 +1,698 @@
# 泰豪电源AI数智化平台 - 数据库设计文档
## 一、系统概述
基于功能结构.xml的系统架构设计，本数据库设计遵循"一个底座、多种智能体"的核心理念，支持四大业务模块：
1. **资料管理智能化**
2. **招投标自动化**
3. **售后客服智能化**
4. **企业内部知识协同**
## 二、数据库架构设计
### 2.1 Schema划分
采用多Schema架构，按业务模块逻辑隔离：
| Schema | 说明 | 核心表数量 |
|--------|------|-----------|
| `sys` | 系统基础模块（用户、角色、权限、部门） | 11 |
| `file` | 文件管理模块 | 1 |
| `message` | 消息通知模块 | 4 |
| `log` | 日志审计模块 | 1 |
| `config` | 系统配置模块 | 1 |
| `knowledge` | 知识库管理模块 | 4 |
| `bidding` | 招投标智能体业务模块 | 8 |
| `customer_service` | 智能客服系统业务模块 | 9 |
| `agent` | 智能体管理和平台基础设施模块 | 11 |
**总计：50张核心业务表**
## 三、核心模块详细设计
### 3.1 系统基础模块 (sys)
#### 3.1.1 权限体系设计
采用**RBAC（基于角色的访问控制）+ ACL（访问控制列表）**混合模型：
**核心表：**
- `tb_sys_user` - 用户表
- `tb_sys_role` - 角色表（支持全局角色和部门私有角色）
- `tb_sys_permission` - 权限表
- `tb_sys_dept` - 部门表（树形结构）
- `tb_sys_acl` - 通用对象级权限表（支持细粒度权限控制）
- `tb_sys_acl_policy` - ACL策略表（层级可见/可编辑规则）
**设计亮点：**
1. **多租户支持**：通过`dept_path`字段实现数据隔离，支持部门级多租户
2. **角色作用域**：`scope`字段区分全局角色和部门私有角色
3. **细粒度权限**：ACL表支持对任意对象类型（文章、文件、课程等）的权限控制
4. **层级权限继承**：`include_descendants`支持子部门/子角色权限继承
#### 3.1.2 用户信息管理
```sql
-- 用户表结构优势
tb_sys_user:
- 支持多种登录方式（email、phone、wechat_id）
- 密码加密存储（建议bcrypt/argon2）
- 软删除机制（deleted + delete_time）
- 时区感知时间戳（timestamptz）
```
### 3.2 知识库管理模块 (knowledge)
#### 3.2.1 表结构设计
**核心表：**
- `tb_knowledge_base` - 知识库定义表
- `tb_knowledge_document` - 知识文档表
- `tb_knowledge_chunk` - 文档片段表（RAG检索）
- `tb_knowledge_access_log` - 访问日志表
**设计亮点：**
1. **多类型知识库支持**
```sql
kb_type:
- bidding -- 招投标知识库
- customer_service -- 客服知识库
- internal -- 内部协同知识库
```
2. **文档智能处理**
- 自动分类（`category`字段）
- AI摘要生成（`content_summary`）
- 关键词提取（`keywords`数组）
- 向量化状态跟踪（`embedding_status`）
3. **RAG检索支持**
- `tb_knowledge_chunk`表存储文档切片
- `embedding`字段存储向量（需pgvector扩展）
- 支持语义检索和混合检索
4. **版本管理**
- `version`字段跟踪文档版本
- `parent_doc_id`构建版本树
### 3.3 招投标智能体业务模块 (bidding)
#### 3.3.1 核心业务流程
```
项目创建 → 文件采集 → 智能解读 → 要素提取 → 投标文件生成 → 审核提交 → 流程跟踪
```
#### 3.3.2 表结构设计
**核心表：**
1. `tb_bidding_project` - 招标项目表（主表）
2. `tb_bidding_document` - 招标文件表
3. `tb_bidding_requirement` - 要素提取表
4. `tb_bid_response` - 投标文件生成表
5. `tb_bidding_scoring_rule` - 评分规则表
6. `tb_bidding_process` - 流程节点表
7. `tb_bid_template` - 投标模板表
**设计亮点：**
1. **完整项目生命周期管理**
```sql
project_status:
- collecting -- 收集中
- analyzing -- 分析中
- preparing -- 准备投标
- submitted -- 已提交
- opened -- 已开标
- won/lost -- 中标/未中标
- abandoned -- 放弃
```
2. **智能要素提取**
- 支持7大类要素（商务、技术、否决项、资质、交付、付款、评分）
- AI提取置信度跟踪
- 来源位置记录（页码、段落）
- 合规状态跟踪
3. **投标文件生成**
- 支持多种生成方式（AI生成、模板生成、人工编写）
- 版本管理（`parent_version_id`）
- 审批流程状态跟踪
4. **评分规则智能分析**
- 多维度评分（技术分、商务分、价格分、信誉分）
- 公式计算支持
- 得分预估和优化建议
### 3.4 智能客服系统业务模块 (customer_service)
#### 3.4.1 核心业务流程
```
客户咨询 → AI问答 → 人工转接 → 工单生成 → 工单处理 → CRM同步 → 满意度评价
```
#### 3.4.2 表结构设计
**核心表：**
1. `tb_customer` - 客户信息表
2. `tb_conversation` - 会话表
3. `tb_conversation_message` - 会话消息表
4. `tb_ticket` - 工单表
5. `tb_ticket_log` - 工单处理记录表
6. `tb_faq` - FAQ表
7. `tb_service_evaluation` - 客服评价表
8. `tb_crm_config` - CRM集成配置表
**设计亮点：**
1. **全渠道客户管理**
- 支持多渠道（微信、网页、APP、电话）
- 客户等级分层（VIP、重要、普通、潜在）
- 标签化管理
- CRM系统ID映射
2. **智能会话管理**
- AI/人工/转接会话类型
- 会话摘要自动生成
- 满意度评价跟踪
- 消息情感分析和意图识别
3. **工单智能处理**
- AI自动生成工单
- SLA超时预警
- 优先级智能判定
- CRM双向同步
4. **知识库引用跟踪**
- `kb_references`字段记录引用的知识库文档
- 支持回答溯源
- 知识库质量评估数据
### 3.5 智能体管理模块 (agent)
#### 3.5.1 核心功能
```
智能体定义 → 工具集成 → API管理 → 会话管理 → 监控运维 → 评价反馈
```
#### 3.5.2 表结构设计
**核心表：**
1. `tb_agent` - 智能体定义表
2. `tb_agent_session` - 智能体会话表
3. `tb_agent_message` - 智能体消息表
4. `tb_agent_tool` - 智能体工具表
5. `tb_api_integration` - API集成注册表
6. `tb_api_call_log` - API调用日志表
7. `tb_agent_metrics` - 智能体监控指标表
8. `tb_agent_error_log` - 智能体异常日志表
9. `tb_agent_rating` - 智能体评价表
**设计亮点：**
1. **智能体广场**
- `is_published`字段支持发布到广场
- 评分和使用次数统计
- 分类和标签管理
- 访问级别控制
2. **工具和API集成**
- 标准化工具定义（OpenAI Function Calling格式）
- 多种认证方式支持
- 健康检查机制
- 调用日志完整记录
3. **监控和运维**
- 按日期/小时的指标聚合
- 成本跟踪（Token使用量、API调用费用）
- 错误日志和堆栈跟踪
- 成功率和响应时间监控
4. **会话管理**
- 支持对话、任务、工作流多种类型
- 上下文管理（JSONB格式）
- Token使用量统计
- 知识库引用跟踪
## 四、数据库优化建议
### 4.1 索引优化
#### 4.1.1 已实现的索引策略
1. **主键索引**：所有表都有主键（通常为业务ID）
2. **唯一索引**：关键业务字段（email、phone、编号等）
3. **外键索引**：关联查询字段
4. **复合索引**：高频查询组合字段
5. **部分索引**：带WHERE条件的索引（减少索引大小）
6. **GIN索引**：数组字段（tags、keywords等）
#### 4.1.2 建议增加的索引
```sql
-- 知识库文档全文搜索索引（需要pg_trgm扩展）
CREATE INDEX idx_knowledge_doc_title_trgm
ON knowledge.tb_knowledge_document USING gin(title gin_trgm_ops);
-- 会话消息内容全文搜索
CREATE INDEX idx_message_content_trgm
ON customer_service.tb_conversation_message USING gin(content gin_trgm_ops);
-- 招标项目名称搜索
CREATE INDEX idx_project_name_trgm
ON bidding.tb_bidding_project USING gin(project_name gin_trgm_ops);
```
### 4.2 性能优化建议
#### 4.2.1 分区表设计
对于数据量大、查询集中在时间范围的表，建议使用分区：
```sql
-- 示例：API调用日志按月分区
CREATE TABLE agent.tb_api_call_log (
-- ... 字段定义
) PARTITION BY RANGE (create_time);
CREATE TABLE agent.tb_api_call_log_2024_01
PARTITION OF agent.tb_api_call_log
FOR VALUES FROM ('2024-01-01') TO ('2024-02-01');
```
**建议分区的表：**
- `agent.tb_api_call_log` - API调用日志
- `log.tb_sys_log` - 系统日志
- `knowledge.tb_knowledge_access_log` - 知识访问日志
- `agent.tb_agent_metrics` - 智能体监控指标（已按日期设计）
#### 4.2.2 JSONB字段优化
```sql
-- 为JSONB字段创建GIN索引
CREATE INDEX idx_agent_model_config_gin
ON agent.tb_agent(model_config) USING gin;
-- 为JSONB内特定键创建表达式索引
CREATE INDEX idx_agent_config_model_name
ON agent.tb_agent((model_config->>'model_name'));
```
#### 4.2.3 数组字段优化
```sql
-- 使用GIN索引支持数组查询
CREATE INDEX idx_kb_doc_tags_gin
ON knowledge.tb_knowledge_document USING gin(tags);
-- 查询示例
SELECT * FROM knowledge.tb_knowledge_document
WHERE tags @> ARRAY['技术文档'];
```
### 4.3 数据归档策略
#### 4.3.1 软删除设计
当前设计使用软删除（`deleted`字段），建议：
1. **定期归档**：将deleted=true且超过6个月的数据移至归档表
2. **归档表命名**：`tb_xxx_archived`
3. **保留必要索引**：归档表仅保留时间范围查询索引
#### 4.3.2 日志数据归档
```sql
-- 日志归档策略
-- 1. API调用日志：保留近3个月，其余归档
-- 2. 系统日志：保留近6个月，其余归档
-- 3. 访问日志：保留近1个月，其余归档
-- 归档函数示例
CREATE OR REPLACE FUNCTION archive_old_logs()
RETURNS void AS $$
BEGIN
-- 归档API调用日志
INSERT INTO agent.tb_api_call_log_archived
SELECT * FROM agent.tb_api_call_log
WHERE create_time < now() - interval '3 months';
DELETE FROM agent.tb_api_call_log
WHERE create_time < now() - interval '3 months';
END;
$$ LANGUAGE plpgsql;
```
### 4.4 查询优化建议
#### 4.4.1 常用查询模式
```sql
-- 1. 用户权限检查（高频查询）
-- 建议：创建物化视图
CREATE MATERIALIZED VIEW sys.mv_user_permissions AS
SELECT
ur.user_id,
array_agg(DISTINCT p.code) AS permissions
FROM sys.tb_sys_user_role ur
JOIN sys.tb_sys_role_permission rp ON ur.role_id = rp.role_id
JOIN sys.tb_sys_permission p ON rp.permission_id = p.permission_id
WHERE ur.deleted = false AND rp.deleted = false
GROUP BY ur.user_id;
CREATE UNIQUE INDEX ON sys.mv_user_permissions(user_id);
-- 定期刷新
REFRESH MATERIALIZED VIEW CONCURRENTLY sys.mv_user_permissions;
```
#### 4.4.2 复杂统计查询优化
```sql
-- 使用CTE和窗口函数优化统计查询
WITH daily_stats AS (
SELECT
DATE(create_time) AS stat_date,
agent_id,
COUNT(*) AS session_count,
SUM(message_count) AS total_messages
FROM agent.tb_agent_session
WHERE deleted = false
GROUP BY DATE(create_time), agent_id
)
SELECT
agent_id,
stat_date,
session_count,
total_messages,
SUM(session_count) OVER (
PARTITION BY agent_id
ORDER BY stat_date
ROWS BETWEEN 6 PRECEDING AND CURRENT ROW
) AS rolling_7day_sessions
FROM daily_stats;
```
## 五、现有SQL文件修改建议
### 5.1 createTableUser.sql 优化
**当前问题：**
1. 登录日志表中存储密码不安全
2. 缺少用户部门关联
**建议修改：**
```sql
-- 1. 移除登录日志表的password字段
ALTER TABLE sys.tb_sys_login_log DROP COLUMN IF EXISTS password;
-- 2. 添加用户部门关联表
CREATE TABLE sys.tb_sys_user_dept (
optsn VARCHAR(50) NOT NULL,
user_id VARCHAR(50) NOT NULL,
dept_id VARCHAR(50) NOT NULL,
is_primary BOOLEAN DEFAULT false, -- 是否主部门
position VARCHAR(100), -- 职位
creator VARCHAR(50) DEFAULT NULL,
create_time timestamptz NOT NULL DEFAULT now(),
update_time timestamptz DEFAULT NULL,
deleted BOOLEAN NOT NULL DEFAULT false,
PRIMARY KEY (user_id, dept_id),
UNIQUE (optsn)
);
-- 3. 用户表添加默认部门字段
ALTER TABLE sys.tb_sys_user
ADD COLUMN IF NOT EXISTS primary_dept_id VARCHAR(50);
```
### 5.2 createTablePermission.sql 优化
**建议修改：**
```sql
-- 1. 角色表添加排序字段
ALTER TABLE sys.tb_sys_role
ADD COLUMN IF NOT EXISTS order_num INTEGER DEFAULT 0;
-- 2. 权限表添加权限类型字段
ALTER TABLE sys.tb_sys_permission
ADD COLUMN IF NOT EXISTS permission_type VARCHAR(20) DEFAULT 'action';
-- permission_type: action-操作权限/data-数据权限/menu-菜单权限
COMMENT ON COLUMN sys.tb_sys_permission.permission_type
IS '权限类型：action-操作权限/data-数据权限/menu-菜单权限';
```
### 5.3 createTableFile.sql 扩展
**建议添加：**
```sql
-- 1. 文件版本管理
ALTER TABLE file.tb_sys_file
ADD COLUMN IF NOT EXISTS version VARCHAR(20) DEFAULT '1.0',
ADD COLUMN IF NOT EXISTS parent_file_id VARCHAR(50),
ADD COLUMN IF NOT EXISTS is_latest BOOLEAN DEFAULT true;
-- 2. 文件分类
ALTER TABLE file.tb_sys_file
ADD COLUMN IF NOT EXISTS category VARCHAR(100),
ADD COLUMN IF NOT EXISTS tags TEXT[];
-- 3. 文件关联（支持文件和业务对象关联）
CREATE TABLE file.tb_file_relation (
optsn VARCHAR(50) NOT NULL,
relation_id VARCHAR(50) NOT NULL,
file_id VARCHAR(50) NOT NULL,
object_type VARCHAR(50) NOT NULL, -- 对象类型：bidding_project/ticket/document等
object_id VARCHAR(50) NOT NULL, -- 对象ID
relation_type VARCHAR(30) DEFAULT 'attachment', -- 关联类型：attachment-附件/avatar-头像/banner-横幅
order_num INTEGER DEFAULT 0,
creator VARCHAR(50) DEFAULT NULL,
create_time timestamptz NOT NULL DEFAULT now(),
deleted BOOLEAN NOT NULL DEFAULT false,
PRIMARY KEY (relation_id),
UNIQUE (optsn),
FOREIGN KEY (file_id) REFERENCES file.tb_sys_file(file_id)
);
CREATE INDEX idx_file_relation_object
ON file.tb_file_relation(object_type, object_id) WHERE deleted = false;
```
### 5.4 createTableMessage.sql 增强
**建议添加：**
```sql
-- 1. 消息模板表
CREATE TABLE message.tb_message_template (
optsn VARCHAR(50) NOT NULL,
template_id VARCHAR(50) NOT NULL,
template_code VARCHAR(100) NOT NULL, -- 模板编码
template_name VARCHAR(255) NOT NULL, -- 模板名称
template_type VARCHAR(30) NOT NULL, -- 模板类型：system-系统/business-业务
title_template TEXT, -- 标题模板（支持变量）
content_template TEXT NOT NULL, -- 内容模板（支持变量）
variables JSONB, -- 变量定义
dept_path VARCHAR(255) DEFAULT NULL,
creator VARCHAR(50) DEFAULT NULL,
updater VARCHAR(50) DEFAULT NULL,
create_time timestamptz NOT NULL DEFAULT now(),
update_time timestamptz DEFAULT NULL,
deleted BOOLEAN NOT NULL DEFAULT false,
PRIMARY KEY (template_id),
UNIQUE (optsn),
UNIQUE (template_code)
);
COMMENT ON TABLE message.tb_message_template IS '消息模板表';
```
## 六、数据安全建议
### 6.1 敏感数据加密
**需要加密的字段：**
1. `sys.tb_sys_user.password` - 用户密码（使用bcrypt/argon2）
2. `agent.tb_agent_tool.auth_config` - API认证配置
3. `agent.tb_api_integration.auth_config` - 集成认证配置
4. `customer_service.tb_crm_config.api_key` - CRM API密钥
**建议使用PostgreSQL的pgcrypto扩展：**
```sql
CREATE EXTENSION IF NOT EXISTS pgcrypto;
-- 加密示例
INSERT INTO agent.tb_agent_tool (auth_config)
VALUES (pgp_sym_encrypt('{"api_key": "secret"}', 'encryption_key'));
-- 解密示例
SELECT pgp_sym_decrypt(auth_config::bytea, 'encryption_key')
FROM agent.tb_agent_tool;
```
### 6.2 行级安全策略（RLS）
```sql
-- 启用行级安全
ALTER TABLE knowledge.tb_knowledge_document ENABLE ROW LEVEL SECURITY;
-- 创建策略：用户只能访问自己部门的文档
CREATE POLICY dept_isolation_policy ON knowledge.tb_knowledge_document
FOR SELECT
USING (
dept_path LIKE (
SELECT dept_path || '%'
FROM sys.tb_sys_user
WHERE user_id = current_setting('app.current_user_id')
)
);
```
### 6.3 审计日志增强
```sql
-- 添加审计触发器
CREATE OR REPLACE FUNCTION audit_trigger_func()
RETURNS TRIGGER AS $$
BEGIN
IF (TG_OP = 'DELETE') THEN
INSERT INTO log.tb_sys_log (
log_id, type, level, module, message, data, creator
) VALUES (
gen_random_uuid()::text,
'audit',
'info',
TG_TABLE_SCHEMA || '.' || TG_TABLE_NAME,
'Record deleted',
row_to_json(OLD),
current_setting('app.current_user_id', true)
);
RETURN OLD;
ELSIF (TG_OP = 'UPDATE') THEN
INSERT INTO log.tb_sys_log (
log_id, type, level, module, message, data, creator
) VALUES (
gen_random_uuid()::text,
'audit',
'info',
TG_TABLE_SCHEMA || '.' || TG_TABLE_NAME,
'Record updated',
jsonb_build_object('old', row_to_json(OLD), 'new', row_to_json(NEW)),
current_setting('app.current_user_id', true)
);
RETURN NEW;
END IF;
END;
$$ LANGUAGE plpgsql;
-- 为敏感表添加审计触发器
CREATE TRIGGER audit_user_changes
AFTER UPDATE OR DELETE ON sys.tb_sys_user
FOR EACH ROW EXECUTE FUNCTION audit_trigger_func();
```
## 七、部署和维护建议
### 7.1 初始化顺序
```bash
# 1. 创建扩展
psql -d urbanlifeline -f extensions.sql
# 2. 按依赖顺序执行建表脚本
psql -d urbanlifeline -f createTablePermission.sql
psql -d urbanlifeline -f createTableUser.sql
psql -d urbanlifeline -f createTableFile.sql
psql -d urbanlifeline -f createTableMessage.sql
psql -d urbanlifeline -f createTableLog.sql
psql -d urbanlifeline -f createTableConfig.sql
psql -d urbanlifeline -f createTableKnowledge.sql
psql -d urbanlifeline -f createTableBidding.sql
psql -d urbanlifeline -f createTableCustomerService.sql
psql -d urbanlifeline -f createTableAgent.sql
# 3. 执行完整初始化（包含触发器和视图）
psql -d urbanlifeline -f createTableAll.sql
# 4. 初始化基础数据
psql -d urbanlifeline -f initDataConfig.sql
```
### 7.2 定期维护任务
```sql
-- 1. 分析和优化表
ANALYZE VERBOSE;
VACUUM ANALYZE;
-- 2. 重建索引（处理索引膨胀）
REINDEX DATABASE urbanlifeline;
-- 3. 更新表统计信息
VACUUM ANALYZE sys.tb_sys_user;
VACUUM ANALYZE agent.tb_agent_session;
-- 4. 检查慢查询
SELECT query, calls, total_time, mean_time
FROM pg_stat_statements
ORDER BY mean_time DESC
LIMIT 20;
```
### 7.3 备份策略
```bash
# 全量备份（每日）
pg_dump -Fc urbanlifeline > backup_$(date +%Y%m%d).dump
# 增量备份（使用WAL归档）
# 在postgresql.conf中配置：
# wal_level = replica
# archive_mode = on
# archive_command = 'cp %p /path/to/archive/%f'
# 恢复示例
pg_restore -d urbanlifeline -c backup_20240101.dump
```
## 八、总结
### 8.1 设计优势
1. **模块化架构**：9个Schema清晰划分业务边界
2. **可扩展性**：支持多租户、多智能体、多业务类型
3. **性能优化**：合理的索引设计、分区策略、视图优化
4. **数据安全**：软删除、审计日志、权限控制、数据加密
5. **业务完整**：覆盖招投标、客服、知识库全流程
### 8.2 后续优化方向
1. **向量检索优化**：引入pgvector扩展，优化RAG检索性能
2. **分布式部署**：考虑Citus扩展实现水平扩展
3. **实时数据同步**：使用Logical Replication实现异地备份
4. **监控告警**：集成pgBadger、pg_stat_statements等工具
5. **读写分离**：主从复制实现读写分离
### 8.3 关键指标
- **总表数**：50+ 张核心表
- **Schema数**：9 个业务Schema
- **索引类型**：B-Tree、GIN、部分索引、表达式索引
- **数据类型**：标准类型 + JSONB + 数组 + 向量（可选）
- **时区支持**：全部使用timestamptz
- **软删除**：全表支持deleted标记
---
**文档版本**: 1.0
**最后更新**: 2024-12-02
**维护团队**: 泰豪电源AI数智化平台开发组