775 lines
21 KiB
Markdown
775 lines
21 KiB
Markdown
# 泰豪电源 AI 数智化平台 - 数据库完整指南
|
||
|
||
> **更新日期**: 2025-12-02
|
||
> **数据库**: PostgreSQL 16
|
||
> **总表数**: 50张核心业务表
|
||
|
||
---
|
||
|
||
## 📖 目录
|
||
|
||
1. [系统概述](#1-系统概述)
|
||
2. [Schema架构](#2-schema架构)
|
||
3. [核心模块设计](#3-核心模块设计)
|
||
4. [表结构速查](#4-表结构速查)
|
||
5. [优化方案](#5-优化方案)
|
||
6. [部署与维护](#6-部署与维护)
|
||
7. [常用查询示例](#7-常用查询示例)
|
||
|
||
---
|
||
|
||
## 1. 系统概述
|
||
|
||
### 1.1 设计理念
|
||
|
||
基于`功能结构.xml`的系统架构，遵循 **"一个底座、多种智能体"** 核心理念，支持四大业务模块：
|
||
|
||
1. **资料管理智能化**
|
||
2. **招投标自动化**
|
||
3. **售后客服智能化**
|
||
4. **企业内部知识协同**
|
||
|
||
### 1.2 技术选型
|
||
|
||
- **数据库**: PostgreSQL 16
|
||
- **连接池**: HikariCP
|
||
- **ORM**: MyBatis-Plus 3.5
|
||
- **迁移工具**: Flyway (可选)
|
||
|
||
### 1.3 设计原则
|
||
|
||
- ✅ **模块化**: 按业务模块划分 Schema
|
||
- ✅ **规范化**: 统一命名规范和字段设计
|
||
- ✅ **可扩展**: 预留扩展字段和软删除
|
||
- ✅ **高性能**: 合理索引和分区设计
|
||
- ✅ **安全性**: 行级安全和审计日志
|
||
|
||
---
|
||
|
||
## 2. Schema架构
|
||
|
||
### 2.1 Schema划分
|
||
|
||
采用多Schema架构，按业务模块逻辑隔离：
|
||
|
||
| Schema | 说明 | 核心表数量 | 用途 |
|
||
|--------|------|-----------|------|
|
||
| `sys` | 系统基础模块 | 11 | 用户、角色、权限、部门 |
|
||
| `file` | 文件管理模块 | 1 | 文件存储与管理 |
|
||
| `message` | 消息通知模块 | 4 | 站内信、系统通知 |
|
||
| `log` | 日志审计模块 | 1 | 操作日志、审计 |
|
||
| `config` | 系统配置模块 | 1 | 系统参数配置 |
|
||
| `knowledge` | 知识库管理模块 | 4 | 文档、分段、问答对 |
|
||
| `bidding` | 招投标智能体 | 8 | 招投标业务流程 |
|
||
| `customer_service` | 智能客服系统 | 9 | 客服、工单、对话 |
|
||
| `agent` | 智能体管理 | 11 | 智能体、API、监控 |
|
||
|
||
**总计: 50张核心业务表**
|
||
|
||
### 2.2 命名规范
|
||
|
||
```sql
|
||
-- Schema 命名: 小写字母
|
||
CREATE SCHEMA IF NOT EXISTS sys;
|
||
|
||
-- 表命名: tb_{schema}_{表名}
|
||
CREATE TABLE sys.tb_sys_user (...);
|
||
CREATE TABLE knowledge.tb_knowledge_document (...);
|
||
|
||
-- 字段命名: 小写字母 + 下划线
|
||
user_id, create_time, full_name
|
||
|
||
-- 索引命名: idx_{表名}_{字段名}
|
||
CREATE INDEX idx_user_email ON sys.tb_sys_user(email);
|
||
|
||
-- 外键命名: fk_{表名}_{关联表名}
|
||
CONSTRAINT fk_user_dept FOREIGN KEY (dept_id) ...
|
||
```
|
||
|
||
---
|
||
|
||
## 3. 核心模块设计
|
||
|
||
### 3.1 系统基础模块 (sys)
|
||
|
||
#### 权限体系设计
|
||
|
||
采用 **RBAC (基于角色的访问控制) + ACL (访问控制列表)** 混合模型
|
||
|
||
**核心表**:
|
||
- `tb_sys_user` - 用户表
|
||
- `tb_sys_role` - 角色表
|
||
- `tb_sys_permission` - 权限表
|
||
- `tb_sys_dept` - 部门表
|
||
- `tb_sys_acl` - 对象级权限表
|
||
- `tb_sys_user_role` - 用户角色关联表
|
||
|
||
**权限模型**:
|
||
```
|
||
用户 (User)
|
||
├─ 部门 (Dept) - 数据隔离
|
||
├─ 角色 (Role)
|
||
│ ├─ 权限 (Permission) - 功能权限
|
||
│ └─ 视图 (View) - 菜单权限
|
||
└─ ACL - 对象级权限（细粒度）
|
||
```
|
||
|
||
**设计亮点**:
|
||
1. 多租户支持: `dept_path` 字段实现部门级数据隔离
|
||
2. 角色作用域: `scope` 字段区分全局/部门角色
|
||
3. 对象权限: ACL表支持任意对象的细粒度权限
|
||
|
||
#### 核心表结构
|
||
|
||
```sql
|
||
-- 用户表
|
||
CREATE TABLE sys.tb_sys_user (
|
||
user_id VARCHAR(50) PRIMARY KEY,
|
||
username VARCHAR(50) UNIQUE NOT NULL,
|
||
password_hash VARCHAR(255) NOT NULL,
|
||
email VARCHAR(100) UNIQUE,
|
||
phone VARCHAR(20),
|
||
wechat_id VARCHAR(100),
|
||
status VARCHAR(20) DEFAULT 'active',
|
||
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
update_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
deleted BOOLEAN DEFAULT false
|
||
);
|
||
|
||
-- 部门表（树形结构）
|
||
CREATE TABLE sys.tb_sys_dept (
|
||
dept_id VARCHAR(50) PRIMARY KEY,
|
||
dept_name VARCHAR(100) NOT NULL,
|
||
parent_id VARCHAR(50),
|
||
dept_path TEXT, -- 路径：/1/2/3/
|
||
sort_order INTEGER DEFAULT 0,
|
||
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
deleted BOOLEAN DEFAULT false,
|
||
CONSTRAINT fk_dept_parent FOREIGN KEY (parent_id)
|
||
REFERENCES sys.tb_sys_dept(dept_id)
|
||
);
|
||
|
||
-- 角色表
|
||
CREATE TABLE sys.tb_sys_role (
|
||
role_id VARCHAR(50) PRIMARY KEY,
|
||
role_name VARCHAR(100) NOT NULL,
|
||
role_code VARCHAR(50) UNIQUE NOT NULL,
|
||
scope VARCHAR(20) DEFAULT 'global', -- global/dept
|
||
owner_dept_id VARCHAR(50),
|
||
description TEXT,
|
||
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
deleted BOOLEAN DEFAULT false
|
||
);
|
||
|
||
-- ACL权限表
|
||
CREATE TABLE sys.tb_sys_acl (
|
||
acl_id VARCHAR(50) PRIMARY KEY,
|
||
object_type VARCHAR(50) NOT NULL, -- user/dept/document等
|
||
object_id VARCHAR(50) NOT NULL,
|
||
principal_type VARCHAR(20) NOT NULL, -- user/role/dept
|
||
principal_id VARCHAR(50) NOT NULL,
|
||
permission VARCHAR(50) NOT NULL, -- view/edit/delete/admin
|
||
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
||
);
|
||
|
||
-- 索引
|
||
CREATE INDEX idx_user_status ON sys.tb_sys_user(status) WHERE deleted = false;
|
||
CREATE INDEX idx_dept_path ON sys.tb_sys_dept USING GIN(dept_path gin_trgm_ops);
|
||
CREATE INDEX idx_acl_object ON sys.tb_sys_acl(object_type, object_id);
|
||
```
|
||
|
||
### 3.2 知识库管理模块 (knowledge)
|
||
|
||
#### 模块概述
|
||
|
||
支持文档管理、向量检索、RAG问答，版本控制。
|
||
|
||
**核心表**:
|
||
- `tb_knowledge_document` - 文档主表
|
||
- `tb_knowledge_chunk` - 文档分段表（向量检索）
|
||
- `tb_knowledge_qa_pair` - 问答对表
|
||
- `tb_knowledge_file_relation` - 文档文件关联表
|
||
|
||
#### 版本管理设计
|
||
|
||
采用 **简化版本管理** 方案：
|
||
|
||
```sql
|
||
-- 文档表（新增版本字段）
|
||
CREATE TABLE knowledge.tb_knowledge_document (
|
||
doc_id VARCHAR(50) PRIMARY KEY,
|
||
root_doc_id VARCHAR(50), -- ✨ 根文档ID（版本组标识）
|
||
version INTEGER DEFAULT 1, -- ✨ 版本号
|
||
is_current BOOLEAN DEFAULT true, -- ✨ 是否当前版本
|
||
title VARCHAR(500) NOT NULL,
|
||
content TEXT,
|
||
knowledge_base_id VARCHAR(50),
|
||
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
deleted BOOLEAN DEFAULT false
|
||
);
|
||
|
||
-- 分段表（向量检索）
|
||
CREATE TABLE knowledge.tb_knowledge_chunk (
|
||
chunk_id VARCHAR(50) PRIMARY KEY,
|
||
doc_id VARCHAR(50) NOT NULL,
|
||
chunk_index INTEGER NOT NULL,
|
||
content TEXT NOT NULL,
|
||
embedding VECTOR(1536), -- ✨ 向量字段（pgvector扩展）
|
||
version INTEGER DEFAULT 1, -- ✨ 乐观锁版本
|
||
tokens INTEGER,
|
||
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
CONSTRAINT fk_chunk_doc FOREIGN KEY (doc_id)
|
||
REFERENCES knowledge.tb_knowledge_document(doc_id)
|
||
);
|
||
|
||
-- 索引
|
||
CREATE INDEX idx_doc_root_current
|
||
ON knowledge.tb_knowledge_document(root_doc_id, is_current)
|
||
WHERE deleted = false;
|
||
|
||
CREATE INDEX idx_chunk_embedding
|
||
ON knowledge.tb_knowledge_chunk
|
||
USING ivfflat (embedding vector_cosine_ops) -- ✨ 向量索引
|
||
WITH (lists = 100);
|
||
```
|
||
|
||
**版本管理示例**:
|
||
|
||
```sql
|
||
-- 创建新版本
|
||
BEGIN;
|
||
|
||
-- 1. 标记旧版本为非当前
|
||
UPDATE knowledge.tb_knowledge_document
|
||
SET is_current = false
|
||
WHERE root_doc_id = 'root_xxx';
|
||
|
||
-- 2. 插入新版本
|
||
INSERT INTO knowledge.tb_knowledge_document (
|
||
doc_id, root_doc_id, version, is_current, title, content
|
||
) VALUES (
|
||
'new_doc_id', 'root_xxx', 2, true, '新版本标题', '内容'
|
||
);
|
||
|
||
COMMIT;
|
||
|
||
-- 查询当前版本
|
||
SELECT * FROM knowledge.tb_knowledge_document
|
||
WHERE root_doc_id = 'root_xxx' AND is_current = true;
|
||
|
||
-- 查询所有版本
|
||
SELECT version, title, create_time
|
||
FROM knowledge.tb_knowledge_document
|
||
WHERE root_doc_id = 'root_xxx'
|
||
ORDER BY version DESC;
|
||
```
|
||
|
||
### 3.3 招投标智能体模块 (bidding)
|
||
|
||
#### 核心表
|
||
|
||
```sql
|
||
-- 招标项目表
|
||
CREATE TABLE bidding.tb_bidding_project (
|
||
project_id VARCHAR(50) PRIMARY KEY,
|
||
project_name VARCHAR(500) NOT NULL,
|
||
project_code VARCHAR(100),
|
||
bidding_org VARCHAR(200), -- 招标单位
|
||
project_type VARCHAR(50), -- 项目类型
|
||
status VARCHAR(50) DEFAULT 'draft',
|
||
budget DECIMAL(18,2),
|
||
bid_deadline TIMESTAMP,
|
||
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
deleted BOOLEAN DEFAULT false
|
||
);
|
||
|
||
-- 招标文件表
|
||
CREATE TABLE bidding.tb_bidding_document (
|
||
doc_id VARCHAR(50) PRIMARY KEY,
|
||
project_id VARCHAR(50) NOT NULL,
|
||
doc_type VARCHAR(50), -- tender/technical/commercial
|
||
file_id VARCHAR(50),
|
||
parsed_content JSONB, -- ✨ 智能解析结果
|
||
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
CONSTRAINT fk_bdoc_project FOREIGN KEY (project_id)
|
||
REFERENCES bidding.tb_bidding_project(project_id)
|
||
);
|
||
|
||
-- 标书模板表
|
||
CREATE TABLE bidding.tb_bidding_template (
|
||
template_id VARCHAR(50) PRIMARY KEY,
|
||
template_name VARCHAR(200) NOT NULL,
|
||
template_type VARCHAR(50),
|
||
content JSONB, -- 模板结构化内容
|
||
variables JSONB, -- 可替换变量
|
||
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
||
);
|
||
```
|
||
|
||
### 3.4 智能客服系统模块 (customer_service)
|
||
|
||
#### 核心表
|
||
|
||
```sql
|
||
-- 对话会话表
|
||
CREATE TABLE customer_service.tb_cs_conversation (
|
||
conv_id VARCHAR(50) PRIMARY KEY,
|
||
customer_user_id VARCHAR(50),
|
||
customer_name VARCHAR(100),
|
||
channel VARCHAR(50), -- wechat/web/phone
|
||
source VARCHAR(50), -- miniprogram/h5/app
|
||
status VARCHAR(50) DEFAULT 'active',
|
||
start_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
end_time TIMESTAMP,
|
||
satisfaction_score INTEGER -- 满意度评分
|
||
);
|
||
|
||
-- 对话消息表
|
||
CREATE TABLE customer_service.tb_cs_message (
|
||
message_id VARCHAR(50) PRIMARY KEY,
|
||
conv_id VARCHAR(50) NOT NULL,
|
||
sender_type VARCHAR(20), -- customer/agent/bot
|
||
sender_id VARCHAR(50),
|
||
content TEXT,
|
||
message_type VARCHAR(50), -- text/image/file
|
||
ai_response JSONB, -- AI响应详情
|
||
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
CONSTRAINT fk_msg_conv FOREIGN KEY (conv_id)
|
||
REFERENCES customer_service.tb_cs_conversation(conv_id)
|
||
);
|
||
|
||
-- 工单表
|
||
CREATE TABLE customer_service.tb_cs_work_order (
|
||
order_id VARCHAR(50) PRIMARY KEY,
|
||
order_code VARCHAR(100) UNIQUE NOT NULL,
|
||
conv_id VARCHAR(50),
|
||
customer_user_id VARCHAR(50),
|
||
title VARCHAR(500) NOT NULL,
|
||
description TEXT,
|
||
category VARCHAR(100),
|
||
priority VARCHAR(20) DEFAULT 'medium',
|
||
status VARCHAR(50) DEFAULT 'pending',
|
||
assigned_to VARCHAR(50),
|
||
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
resolve_time TIMESTAMP
|
||
);
|
||
```
|
||
|
||
### 3.5 智能体管理模块 (agent)
|
||
|
||
#### 核心表
|
||
|
||
```sql
|
||
-- 智能体定义表
|
||
CREATE TABLE agent.tb_agent_definition (
|
||
agent_id VARCHAR(50) PRIMARY KEY,
|
||
agent_name VARCHAR(100) NOT NULL,
|
||
agent_type VARCHAR(50), -- bidding/cs/knowledge等
|
||
description TEXT,
|
||
config JSONB, -- 配置（模型、参数等）
|
||
status VARCHAR(20) DEFAULT 'active',
|
||
version VARCHAR(20),
|
||
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
||
);
|
||
|
||
-- API调用日志表
|
||
CREATE TABLE agent.tb_agent_api_log (
|
||
log_id VARCHAR(50) PRIMARY KEY,
|
||
agent_id VARCHAR(50),
|
||
api_endpoint VARCHAR(200),
|
||
request_params JSONB,
|
||
response_data JSONB,
|
||
status_code INTEGER,
|
||
duration_ms INTEGER,
|
||
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
||
);
|
||
|
||
-- 智能体监控表（按月分区）
|
||
CREATE TABLE agent.tb_agent_monitor (
|
||
monitor_id VARCHAR(50) NOT NULL,
|
||
agent_id VARCHAR(50) NOT NULL,
|
||
metric_name VARCHAR(100),
|
||
metric_value NUMERIC,
|
||
timestamp TIMESTAMP NOT NULL,
|
||
PRIMARY KEY (monitor_id, timestamp)
|
||
) PARTITION BY RANGE (timestamp);
|
||
|
||
-- 创建分区
|
||
CREATE TABLE agent.tb_agent_monitor_2025_12
|
||
PARTITION OF agent.tb_agent_monitor
|
||
FOR VALUES FROM ('2025-12-01') TO ('2026-01-01');
|
||
```
|
||
|
||
---
|
||
|
||
## 4. 表结构速查
|
||
|
||
### 4.1 系统基础模块 (sys)
|
||
|
||
| 表名 | 主键 | 核心字段 | 说明 |
|
||
|------|------|----------|------|
|
||
| `tb_sys_user` | user_id | username, email, phone | 用户表 |
|
||
| `tb_sys_user_info` | user_id | avatar, full_name, 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_acl` | acl_id | object_type, principal_type | 对象权限表 |
|
||
|
||
### 4.2 知识库管理 (knowledge)
|
||
|
||
| 表名 | 主键 | 核心字段 | 说明 |
|
||
|------|------|----------|------|
|
||
| `tb_knowledge_document` | doc_id | title, root_doc_id, version | 文档表 |
|
||
| `tb_knowledge_chunk` | chunk_id | doc_id, content, embedding | 分段表 |
|
||
| `tb_knowledge_qa_pair` | qa_pair_id | question, answer | 问答对表 |
|
||
|
||
### 4.3 招投标 (bidding)
|
||
|
||
| 表名 | 主键 | 核心字段 | 说明 |
|
||
|------|------|----------|------|
|
||
| `tb_bidding_project` | project_id | project_name, status | 招标项目表 |
|
||
| `tb_bidding_document` | doc_id | project_id, parsed_content | 招标文件表 |
|
||
| `tb_bidding_template` | template_id | template_name, content | 标书模板表 |
|
||
|
||
### 4.4 智能客服 (customer_service)
|
||
|
||
| 表名 | 主键 | 核心字段 | 说明 |
|
||
|------|------|----------|------|
|
||
| `tb_cs_conversation` | conv_id | customer_user_id, status | 对话会话表 |
|
||
| `tb_cs_message` | message_id | conv_id, content | 对话消息表 |
|
||
| `tb_cs_work_order` | order_id | title, status, assigned_to | 工单表 |
|
||
|
||
---
|
||
|
||
## 5. 优化方案
|
||
|
||
### 5.1 索引优化
|
||
|
||
```sql
|
||
-- 1. 复合索引（状态 + 时间查询）
|
||
CREATE INDEX idx_project_status_time
|
||
ON bidding.tb_bidding_project(status, create_time DESC)
|
||
WHERE deleted = false;
|
||
|
||
-- 2. 部分索引（只索引活跃数据）
|
||
CREATE INDEX idx_user_active
|
||
ON sys.tb_sys_user(user_id)
|
||
WHERE status = 'active' AND deleted = false;
|
||
|
||
-- 3. GIN索引（全文检索）
|
||
CREATE INDEX idx_doc_content_gin
|
||
ON knowledge.tb_knowledge_document
|
||
USING GIN(to_tsvector('chinese', title || ' ' || content));
|
||
|
||
-- 4. BRIN索引（时间序列）
|
||
CREATE INDEX idx_log_time_brin
|
||
ON log.tb_operation_log
|
||
USING BRIN(create_time);
|
||
```
|
||
|
||
### 5.2 分区策略
|
||
|
||
```sql
|
||
-- 按月分区（监控数据）
|
||
CREATE TABLE agent.tb_agent_monitor (
|
||
monitor_id VARCHAR(50) NOT NULL,
|
||
timestamp TIMESTAMP NOT NULL,
|
||
...
|
||
PRIMARY KEY (monitor_id, timestamp)
|
||
) PARTITION BY RANGE (timestamp);
|
||
|
||
-- 自动创建分区脚本
|
||
CREATE OR REPLACE FUNCTION create_monthly_partition()
|
||
RETURNS void AS $$
|
||
DECLARE
|
||
start_date DATE;
|
||
end_date DATE;
|
||
partition_name TEXT;
|
||
BEGIN
|
||
start_date := DATE_TRUNC('month', CURRENT_DATE + INTERVAL '1 month');
|
||
end_date := start_date + INTERVAL '1 month';
|
||
partition_name := 'tb_agent_monitor_' || TO_CHAR(start_date, 'YYYY_MM');
|
||
|
||
EXECUTE format(
|
||
'CREATE TABLE IF NOT EXISTS agent.%I PARTITION OF agent.tb_agent_monitor
|
||
FOR VALUES FROM (%L) TO (%L)',
|
||
partition_name, start_date, end_date
|
||
);
|
||
END;
|
||
$$ LANGUAGE plpgsql;
|
||
```
|
||
|
||
### 5.3 查询优化
|
||
|
||
```sql
|
||
-- 使用CTE优化复杂查询
|
||
WITH user_roles AS (
|
||
SELECT ur.user_id, r.role_id, r.role_code
|
||
FROM sys.tb_sys_user_role ur
|
||
JOIN sys.tb_sys_role r ON ur.role_id = r.role_id
|
||
WHERE r.deleted = false
|
||
),
|
||
user_permissions AS (
|
||
SELECT ur.user_id, p.permission_code
|
||
FROM user_roles 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
|
||
)
|
||
SELECT u.username, array_agg(DISTINCT up.permission_code) as permissions
|
||
FROM sys.tb_sys_user u
|
||
JOIN user_permissions up ON u.user_id = up.user_id
|
||
WHERE u.deleted = false
|
||
GROUP BY u.user_id, u.username;
|
||
```
|
||
|
||
### 5.4 并发控制
|
||
|
||
```sql
|
||
-- 乐观锁（版本号）
|
||
UPDATE knowledge.tb_knowledge_chunk
|
||
SET content = '新内容',
|
||
version = version + 1
|
||
WHERE chunk_id = 'xxx'
|
||
AND version = 1; -- 版本匹配才更新
|
||
|
||
-- 悲观锁
|
||
BEGIN;
|
||
SELECT * FROM bidding.tb_bidding_project
|
||
WHERE project_id = 'xxx'
|
||
FOR UPDATE; -- 锁定记录
|
||
|
||
-- 更新...
|
||
COMMIT;
|
||
```
|
||
|
||
---
|
||
|
||
## 6. 部署与维护
|
||
|
||
### 6.1 初始化脚本
|
||
|
||
```bash
|
||
# 位置: urbanLifelineServ/.bin/database/postgres/sql/
|
||
|
||
# 完整初始化
|
||
psql -U postgres -d urban_lifeline -f createTableAll.sql
|
||
|
||
# 分模块初始化
|
||
psql -U postgres -d urban_lifeline -f createTablePermission.sql
|
||
psql -U postgres -d urban_lifeline -f createTableKnowledge.sql
|
||
psql -U postgres -d urban_lifeline -f createTableBidding.sql
|
||
|
||
# 优化补丁
|
||
psql -U postgres -d urban_lifeline -f optimizations.sql
|
||
```
|
||
|
||
### 6.2 备份策略
|
||
|
||
```bash
|
||
# 全量备份
|
||
pg_dump -U postgres -d urban_lifeline -F c -f backup_$(date +%Y%m%d).dump
|
||
|
||
# 仅备份 Schema
|
||
pg_dump -U postgres -d urban_lifeline -s -f schema_backup.sql
|
||
|
||
# 仅备份数据
|
||
pg_dump -U postgres -d urban_lifeline -a -f data_backup.sql
|
||
|
||
# 还原
|
||
pg_restore -U postgres -d urban_lifeline backup_20251202.dump
|
||
```
|
||
|
||
### 6.3 监控指标
|
||
|
||
```sql
|
||
-- 表大小
|
||
SELECT
|
||
schemaname,
|
||
tablename,
|
||
pg_size_pretty(pg_total_relation_size(schemaname||'.'||tablename)) as size
|
||
FROM pg_tables
|
||
WHERE schemaname NOT IN ('pg_catalog', 'information_schema')
|
||
ORDER BY pg_total_relation_size(schemaname||'.'||tablename) DESC;
|
||
|
||
-- 索引使用情况
|
||
SELECT
|
||
schemaname, tablename, indexname,
|
||
idx_scan as index_scans,
|
||
idx_tup_read as tuples_read
|
||
FROM pg_stat_user_indexes
|
||
WHERE idx_scan = 0
|
||
ORDER BY schemaname, tablename;
|
||
|
||
-- 慢查询
|
||
SELECT
|
||
query,
|
||
calls,
|
||
total_time,
|
||
mean_time,
|
||
max_time
|
||
FROM pg_stat_statements
|
||
WHERE mean_time > 1000 -- 超过1秒
|
||
ORDER BY mean_time DESC
|
||
LIMIT 10;
|
||
```
|
||
|
||
---
|
||
|
||
## 7. 常用查询示例
|
||
|
||
### 7.1 用户权限查询
|
||
|
||
```sql
|
||
-- 查询用户的所有权限
|
||
SELECT DISTINCT p.permission_code, p.permission_name
|
||
FROM sys.tb_sys_user u
|
||
JOIN sys.tb_sys_user_role ur ON u.user_id = ur.user_id
|
||
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 u.username = 'admin'
|
||
AND u.deleted = false;
|
||
|
||
-- 查询部门下所有用户
|
||
WITH RECURSIVE dept_tree AS (
|
||
SELECT dept_id FROM sys.tb_sys_dept WHERE dept_id = 'target_dept_id'
|
||
UNION ALL
|
||
SELECT d.dept_id
|
||
FROM sys.tb_sys_dept d
|
||
JOIN dept_tree dt ON d.parent_id = dt.dept_id
|
||
)
|
||
SELECT u.*
|
||
FROM sys.tb_sys_user u
|
||
JOIN sys.tb_sys_user_dept ud ON u.user_id = ud.user_id
|
||
WHERE ud.dept_id IN (SELECT dept_id FROM dept_tree);
|
||
```
|
||
|
||
### 7.2 知识库查询
|
||
|
||
```sql
|
||
-- 向量相似度检索（Top 5）
|
||
SELECT
|
||
chunk_id,
|
||
content,
|
||
1 - (embedding <=> '[0.1, 0.2, ...]'::vector) as similarity
|
||
FROM knowledge.tb_knowledge_chunk
|
||
WHERE deleted = false
|
||
ORDER BY embedding <=> '[0.1, 0.2, ...]'::vector
|
||
LIMIT 5;
|
||
|
||
-- 查询文档的所有版本
|
||
SELECT
|
||
version,
|
||
title,
|
||
create_time,
|
||
is_current
|
||
FROM knowledge.tb_knowledge_document
|
||
WHERE root_doc_id = 'root_xxx'
|
||
ORDER BY version DESC;
|
||
```
|
||
|
||
### 7.3 招投标查询
|
||
|
||
```sql
|
||
-- 统计项目状态分布
|
||
SELECT
|
||
status,
|
||
COUNT(*) as count,
|
||
SUM(budget) as total_budget
|
||
FROM bidding.tb_bidding_project
|
||
WHERE deleted = false
|
||
GROUP BY status;
|
||
|
||
-- 查询即将截止的项目
|
||
SELECT
|
||
project_name,
|
||
bid_deadline,
|
||
EXTRACT(DAY FROM (bid_deadline - NOW())) as days_left
|
||
FROM bidding.tb_bidding_project
|
||
WHERE status = 'active'
|
||
AND bid_deadline > NOW()
|
||
AND deleted = false
|
||
ORDER BY bid_deadline ASC;
|
||
```
|
||
|
||
### 7.4 智能客服查询
|
||
|
||
```sql
|
||
-- 查询工单处理效率
|
||
SELECT
|
||
assigned_to,
|
||
COUNT(*) as total_orders,
|
||
AVG(EXTRACT(EPOCH FROM (resolve_time - create_time))/3600) as avg_hours,
|
||
COUNT(CASE WHEN status = 'resolved' THEN 1 END) as resolved_count
|
||
FROM customer_service.tb_cs_work_order
|
||
WHERE create_time > NOW() - INTERVAL '30 days'
|
||
GROUP BY assigned_to;
|
||
|
||
-- 查询满意度统计
|
||
SELECT
|
||
DATE(start_time) as date,
|
||
AVG(satisfaction_score) as avg_satisfaction,
|
||
COUNT(*) as total_conversations
|
||
FROM customer_service.tb_cs_conversation
|
||
WHERE satisfaction_score IS NOT NULL
|
||
AND start_time > NOW() - INTERVAL '7 days'
|
||
GROUP BY DATE(start_time)
|
||
ORDER BY date DESC;
|
||
```
|
||
|
||
---
|
||
|
||
## 附录
|
||
|
||
### A. SQL文件清单
|
||
|
||
```
|
||
urbanLifelineServ/.bin/database/postgres/sql/
|
||
├── createTableAll.sql # 完整初始化
|
||
├── createTablePermission.sql # 权限模块
|
||
├── createTableUser.sql # 用户模块
|
||
├── createTableFile.sql # 文件模块
|
||
├── createTableMessage.sql # 消息模块
|
||
├── createTableLog.sql # 日志模块
|
||
├── createTableConfig.sql # 配置模块
|
||
├── createTableKnowledge.sql # 知识库模块 ✨
|
||
├── createTableBidding.sql # 招投标模块 ✨
|
||
├── createTableCustomerService.sql # 智能客服模块 ✨
|
||
├── createTableAgent.sql # 智能体管理模块 ✨
|
||
├── optimizations.sql # 优化补丁 ✨
|
||
├── initDataPermission.sql # 权限初始数据
|
||
├── initDataUser.sql # 用户初始数据
|
||
└── initAll.sql # 完整初始化（表+数据）
|
||
```
|
||
|
||
### B. 扩展插件
|
||
|
||
```sql
|
||
-- 向量检索
|
||
CREATE EXTENSION IF NOT EXISTS vector;
|
||
|
||
-- 全文检索（中文）
|
||
CREATE EXTENSION IF NOT EXISTS zhparser;
|
||
CREATE TEXT SEARCH CONFIGURATION chinese (PARSER = zhparser);
|
||
|
||
-- 模糊匹配
|
||
CREATE EXTENSION IF NOT EXISTS pg_trgm;
|
||
|
||
-- UUID生成
|
||
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
|
||
```
|
||
|
||
### C. 性能基准
|
||
|
||
| 指标 | 目标值 | 说明 |
|
||
|------|--------|------|
|
||
| 单表查询 | < 100ms | 主键/索引查询 |
|
||
| 复杂查询 | < 500ms | 多表JOIN |
|
||
| 向量检索 | < 200ms | Top-K检索 |
|
||
| 写入TPS | > 1000 | 批量插入 |
|
||
| 并发连接 | 200+ | HikariCP连接池 |
|
||
|
||
---
|
||
|
||
**最后更新**: 2025-12-02
|
||
**维护者**: Urban Lifeline Team
|