Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(aia): Complete AIA V2.0 with universal streaming capabilities

Browse Source 
Major Changes:
- Add StreamingService with OpenAI Compatible format
- Upgrade Chat component V2 with Ant Design X integration
- Implement AIA module with 12 intelligent agents
- Update API routes to unified /api/v1 prefix
- Update system documentation

Backend (~1300 lines):
- common/streaming: OpenAI Compatible adapter
- modules/aia: 12 agents, conversation service, streaming integration
- Update route versions (RVW, PKB to v1)

Frontend (~3500 lines):
- modules/aia: AgentHub + ChatWorkspace (100% prototype restoration)
- shared/Chat: AIStreamChat, ThinkingBlock, useAIStream Hook
- Update API endpoints to v1

Documentation:
- AIA module status guide
- Universal capabilities catalog
- System overview updates
- All module documentation sync

Tested: Stream response verified, authentication working
Status: AIA V2.0 core completed (85%)
This commit is contained in:
HaHafeng
2026-01-14 19:15:01 +08:00
parent 3d35e9c58b
commit 1b53ab9d52
386 changed files with 52096 additions and 65238 deletions
Download Patch File Download Diff File Expand all files Collapse all files

98
docs/_templates/数据库设计-模板.md vendored
View File

@@ -1,25 +1,25 @@
# [模块名称] - 数据库设计
# [璅∪<EFBFBD><EFBFBD>滨妍] - <20>唳旿摨栞挽霈?
> **Schema：** `xxx_schema`
> **表数量：** X个
> **依赖：** platform_schema.users（如有）
> **Schema嚗?* `xxx_schema`
> **銵冽㺭<EFBFBD>𧶏<EFBFBD>** X銝?
> **靘肽<EFBFBD>嚗?* platform_schema.users嚗<EFBFBD><EFBFBD><EFBFBD>㚁<EFBFBD>
> **<2A><><EFBFBD>擧凒<E693A7>堆<EFBFBD>** YYYY-MM-DD
---
## <20><> Schema霂湔<E99C82>
**Schema创建：**
**Schema<EFBFBD>𥕦遣嚗?*
```sql
CREATE SCHEMA IF NOT EXISTS xxx_schema;
```
**职责范围：**
**<EFBFBD>諹提<EFBFBD><EFBFBD>凒嚗?*
- <20>蠘<EFBFBD>1<EFBFBD>詨<EFBFBD><E8A9A8>唳旿
- <20>蠘<EFBFBD>2<EFBFBD>詨<EFBFBD><E8A9A8>唳旿
- ...
**依赖关系：**
**靘肽<EFBFBD><EFBFBD>喟頂嚗?*
- 靘肽<E99D98> `platform_schema.users`嚗<EFBFBD>鍂<EFBFBD>瑚縑<EFBFBD>荔<EFBFBD>
- 靘肽<E99D98> `platform_schema.xxx`嚗<EFBFBD><EFBFBD><EFBFBD>㚁<EFBFBD>
@@ -28,30 +28,30 @@ CREATE SCHEMA IF NOT EXISTS xxx_schema;
## <20><> ER<45>橘<EFBFBD><E6A998>舫<EFBFBD>㚁<EFBFBD>
```
┌─────────────────┐
│ users (外部) │
└────────┬────────┘
│ 1:N
▼
┌─────────────────┐
│ 主表 │
└────────┬────────┘
│ 1:N
▼
┌─────────────────┐
│ 子表 │
└─────────────────┘
<EFBFBD>𢞖<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>? users (憭㚚<EFBFBD>) <EFBFBD>?
<EFBFBD>婙<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>砂<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>?1:N
<EFBFBD>?
<EFBFBD>𢞖<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>? 銝餉” <EFBFBD>?
<EFBFBD>婙<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>砂<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>?1:N
<EFBFBD>?
<EFBFBD>𢞖<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>? 摮鞱” <EFBFBD>?
<EFBFBD>婙<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
```
---
## 📋 表结构设计
## <EFBFBD><EFBFBD> 銵函<E98AB5><E587BD><EFBFBD>挽霈?
### 1. xxx_table_name（表描述）
### 1. xxx_table_name嚗<EFBFBD>”<EFBFBD>讛膩嚗?
**用途：** 简要说明表的用途
**<EFBFBD>券<EFBFBD>䈑<EFBFBD>** 蝞<>閬<EFBFBD>秩<EFBFBD>舘”<E88898><E2809D>鍂<EFBFBD>?
**字段说明：**
**摮埈挾霂湔<EFBFBD>嚗?*
```sql
CREATE TABLE xxx_schema.xxx_table_name (
@@ -66,7 +66,7 @@ CREATE TABLE xxx_schema.xxx_table_name (
description TEXT,
status VARCHAR(20) DEFAULT 'active',
-- 时间戳（必须）
-- <EFBFBD>園𡢿<EFBFBD>喉<EFBFBD>敹<EFBFBD>◆嚗?
created_at TIMESTAMP DEFAULT NOW(),
updated_at TIMESTAMP DEFAULT NOW(),
@@ -76,9 +76,9 @@ CREATE TABLE xxx_schema.xxx_table_name (
);
```
**字段详解：**
**摮埈挾霂西圾嚗?*
| 字段名 | 类型 | 约束 | 说明 |
| 摮埈挾<EFBFBD>?| 蝐餃<E89D90> | 蝥行<E89DA5> | 霂湔<E99C82> |
|--------|------|------|------|
| id | SERIAL | PK | 銝駁睸 |
| user_id | INTEGER | FK, NOT NULL | <20>冽<EFBFBD>ID |
@@ -88,8 +88,8 @@ CREATE TABLE xxx_schema.xxx_table_name (
| created_at | TIMESTAMP | NOT NULL | <20>𥕦遣<F0A595A6>園𡢿 |
| updated_at | TIMESTAMP | NOT NULL | <20>湔鰵<E6B994>園𡢿 |
**业务规则：**
- 每个用户最多创建X个记录
**銝𡁜𦛚閫<EFBFBD><EFBFBD>嚗?*
- 瘥譍葵<EFBFBD>冽<EFBFBD><EFBFBD><EFBFBD>憭𡁜<EFBFBD>撱旗銝芾扇敶?
- status摮埈挾<E59F88><E68CBE><EFBFBD><EFBFBD><EFBFBD><EFBFBD>潘<EFBFBD>active, inactive, deleted
- 頧臬<E9A0A7><E887AC>歹<EFBFBD>銝滨<E98A9D><E6BBA8><EFBFBD><EFBFBD><EFBFBD>歹<EFBFBD><E6ADB9>芯耨<E88AAF>零tatus銝榛eleted
@@ -97,7 +97,7 @@ CREATE TABLE xxx_schema.xxx_table_name (
### 2. xxx_table_name_2嚗<32>洵鈭䔶葵銵剁<E98AB5>
（重复上面的结构）
嚗<EFBFBD><EFBFBD>憭滢<EFBFBD><EFBFBD>Ｙ<EFBFBD>蝏𤘪<EFBFBD>嚗?
---
@@ -105,7 +105,7 @@ CREATE TABLE xxx_schema.xxx_table_name (
### <20>訫<EFBFBD>蝝Ｗ<E89D9D>
```sql
-- 用户ID索引（外键必须加索引）
-- <EFBFBD>冽<EFBFBD>ID蝝Ｗ<EFBFBD>嚗<EFBFBD><EFBFBD><EFBFBD>桀<EFBFBD>憿餃<EFBFBD>蝝Ｗ<EFBFBD>嚗?
CREATE INDEX idx_xxx_user_id ON xxx_schema.xxx_table_name(user_id);
-- <20>嗆<EFBFBD><E59786>揣撘𤏪<E69298>撣貊鍂蝑偦<E89D91>匧<EFBFBD>畾蛛<E795BE>
@@ -117,7 +117,7 @@ CREATE INDEX idx_xxx_created_at ON xxx_schema.xxx_table_name(created_at DESC);
### 憭滚<E686AD>蝝Ｗ<E89D9D>
```sql
-- 用户+状态组合查询
-- <EFBFBD>冽<EFBFBD>+<2B>嗆<EFBFBD><E59786><EFBFBD><EFBFBD><EFBFBD>䰻霂?
CREATE INDEX idx_xxx_user_status ON xxx_schema.xxx_table_name(user_id, status);
```
@@ -127,13 +127,13 @@ CREATE INDEX idx_xxx_user_status ON xxx_schema.xxx_table_name(user_id, status);
### 靘肽<E99D98><E882BD>喟頂
```sql
-- 依赖用户表
-- 靘肽<EFBFBD><EFBFBD>冽<EFBFBD>銵?
ALTER TABLE xxx_schema.xxx_table_name
ADD CONSTRAINT fk_xxx_users
FOREIGN KEY (user_id) REFERENCES platform_schema.users(id)
ON DELETE CASCADE; -- 用户删除时级联删除
ON DELETE CASCADE; -- <EFBFBD>冽<EFBFBD><EFBFBD>𣳇膄<EFBFBD>嗥漣<EFBFBD>𥪜<EFBFBD><EFBFBD>?
-- 模块内关联
-- 璅∪<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
ALTER TABLE xxx_schema.child_table
ADD CONSTRAINT fk_child_parent
FOREIGN KEY (parent_id) REFERENCES xxx_schema.parent_table(id)
@@ -141,14 +141,14 @@ ALTER TABLE xxx_schema.child_table
```
### 憭㚚睸蝑𣇉裦
- ✅ **ON DELETE CASCADE**：用户删除时，自动删除所有关联数据
- ⚠️ **跨Schema外键**：只能引用 platform_schema，不能引用其他业务模块
- <EFBFBD>?**ON DELETE CASCADE**嚗𡁶鍂<F0A181B6>瑕<EFBFBD><E79195>斗𧒄嚗諹䌊<E8ABB9>典<EFBFBD><E585B8>斗<EFBFBD><E69697>匧<EFBFBD><E58CA7>娍㺭<E5A88D>?
- <EFBFBD>𩤃<EFBFBD> **頝沒chema憭㚚睸**嚗𡁜蘨<F0A1819C>賢<EFBFBD><E8B3A2>?platform_schema嚗䔶<E59A97><E494B6>賢<EFBFBD><E8B3A2>典<EFBFBD>隞碶<E99A9E><E7A2B6>⊥芋<E28AA5>?
---
## <20><> <20>唳旿餈<E697BF>宏嚗<E5AE8F>虾<EFBFBD>㚁<EFBFBD>
### 初始化数据
### <EFBFBD>嘥<EFBFBD><EFBFBD>𡝗㺭<EFBFBD>?
```sql
-- 憒<><E68692><EFBFBD><EFBFBD>閬<EFBFBD><E996AC>憪见<E686AA><E8A781>唳旿
INSERT INTO xxx_schema.xxx_table_name (field_name, status) VALUES
@@ -164,40 +164,40 @@ INSERT INTO xxx_schema.xxx_table_name (field_name, status) VALUES
---
## 📊 数据量预估
## <EFBFBD><EFBFBD> <20>唳旿<E594B3>誯<EFBFBD>隡?
| 表名 | 预估记录数 | 增长速度 |
| 銵典<EFBFBD> | 憸<>摯霈啣<E99C88><E595A3>?| 憓鮋鵭<E9AE8B>笔漲 |
|------|-----------|---------|
| xxx_table_name | 10万/年 | 中等 |
| xxx_table_name_2 | 100万/年 | 高 |
| xxx_table_name | 10銝?撟?| 銝剔<E98A9D> |
| xxx_table_name_2 | 100銝?撟?| 擃?|
---
## <20>𩤃<EFBFBD> 瘜冽<E7989C>鈭钅★
**性能优化：**
**<EFBFBD>扯<EFBFBD>隡睃<EFBFBD>嚗?*
- 憭扯”敹<E2809D>◆瘛餃<E7989B><E9A483><EFBFBD>△<EFBFBD>亥砭
- <20>剔<EFBFBD>摮埈挾敹<E68CBE>◆瘛餃<E7989B>蝝Ｗ<E89D9D>
- 摰𡁏<E691B0>皜<EFBFBD><E79A9C>頧臬<E9A0A7><E887AC>斤<EFBFBD><E696A4>唳旿
**摰匧<E691B0><E58CA7>改<EFBFBD>**
- 敏感字段需要加密存储
- <EFBFBD>𤩺<EFBFBD>摮埈挾<EFBFBD><EFBFBD>閬<EFBFBD><EFBFBD>撖<EFBFBD><EFBFBD><EFBFBD>?
- <20><><EFBFBD>匧<EFBFBD><E58CA7>桀<EFBFBD>憿餅<E686BF> ON DELETE 蝑𣇉裦
- <20>踹<EFBFBD>N+1<>亥砭<E4BAA5>桅<EFBFBD>
**蝏湔擪<E6B994>改<EFBFBD>**
- 銵函<E98AB5><E587BD><EFBFBD><EFBFBD><EFBFBD>湧<EFBFBD>閬<EFBFBD><E996AC>餈<EFBFBD>宏<EFBFBD>𡁏𧋦
- 重要变更需要备份数据
- <EFBFBD>滩<EFBFBD><EFBFBD>䀹凒<EFBFBD><EFBFBD>閬<EFBFBD><EFBFBD>隞賣㺭<EFBFBD>?
---
## <20><> <20>詨<EFBFBD><E8A9A8><EFBFBD>﹝
**规范：**
- [数据库设计规范](../../04-开发规范/01-数据库设计规范.md)
- [数据库全局视图](../../04-开发规范/03-数据库全局视图.md)
**閫<EFBFBD><EFBFBD>嚗?*
- [<EFBFBD>唳旿摨栞挽霈∟<EFBFBD><EFBFBD><EFBFBD>(../../04-撘<><E69298>𤏸<EFBFBD><F0A48FB8>?01-<2D>唳旿摨栞挽霈∟<E99C88><E2889F>?md)
- [<EFBFBD>唳旿摨枏<EFBFBD>撅<EFBFBD>閫<EFBFBD>㦛](../../04-撘<EFBFBD><EFBFBD>𤏸<EFBFBD><EFBFBD>?03-<2D>唳旿摨枏<E691A8>撅<EFBFBD>閫<EFBFBD>㦛.md)
**API设计：**
**API霈曇恣嚗?*
- [<EFBFBD>祆芋<EFBFBD>嫎PI霈曇恣](./02-API霈曇恣.md)
---