docs: complete documentation system (250+ files)
- System architecture and design documentation - Business module docs (ASL/AIA/PKB/RVW/DC/SSA/ST) - ASL module complete design (quality assurance, tech selection) - Platform layer and common capabilities docs - Development standards and API specifications - Deployment and operations guides - Project management and milestone tracking - Architecture implementation reports - Documentation templates and guides
This commit is contained in:
167
docs/00-系统总体设计/[AI对接] 快速上下文.md
Normal file
167
docs/00-系统总体设计/[AI对接] 快速上下文.md
Normal file
@@ -0,0 +1,167 @@
|
||||
# [AI对接] 快速上下文
|
||||
|
||||
> **阅读时间：** 2分钟
|
||||
> **Token消耗：** ~800 tokens
|
||||
> **适用场景：** 新AI首次对话，快速了解项目全貌
|
||||
> **文档版本：** v2.0
|
||||
> **最后更新：** 2025-11-06
|
||||
|
||||
---
|
||||
|
||||
## 一句话描述
|
||||
|
||||
**壹证循AI科研平台**：覆盖医学科研全流程的智能化平台，包含8个业务模块，支持4种部署模式（SaaS、独立产品、单机版、私有化）。
|
||||
|
||||
---
|
||||
|
||||
## 📊 核心信息卡片
|
||||
|
||||
### 项目状态
|
||||
- **当前阶段：** 架构设计完成，文档重构中
|
||||
- **已完成：** AIA(AI问答)、PKB(知识库)、RVW(审稿)核心功能
|
||||
- **下一步：** ASL(AI智能文献)模块开发
|
||||
- **技术栈：** Node.js + React + PostgreSQL + Python微服务
|
||||
|
||||
### 8个业务模块（优先级排序）
|
||||
|
||||
| 模块 | 名称 | 状态 | 优先级 | 说明 |
|
||||
|------|------|------|--------|------|
|
||||
| **ASL** | AI智能文献 | ⏳ 下一步 | P0 | 文献筛选、提取、分析 |
|
||||
| **AIA** | AI智能问答 | ✅ 已完成 | - | 12个智能体、多轮对话 |
|
||||
| **PKB** | 个人知识库 | ✅ 已完成 | - | RAG问答、智能引用 |
|
||||
| **RVW** | 稿件审查 | ⚡ 独立系统 | P1 | 稿约规范性+方法学评估 |
|
||||
| **ADMIN** | 运营管理端 | ⏳ 规划中 | P1 | 15个功能模块 |
|
||||
| **DC** | 数据清洗 | ⏳ 规划中 | P1 | 核心竞争力 |
|
||||
| **SSA** | 智能统计 | ⏳ 规划中 | P2 | 3条分析路径 |
|
||||
| **ST** | 统计工具 | ⏳ 规划中 | P2 | 100+小工具 |
|
||||
|
||||
### 关键架构决策
|
||||
1. ✅ **三层架构：** 平台层 + 通用能力层 + 业务模块层
|
||||
2. ⏳ **Schema隔离：** 即将实施（1周）
|
||||
3. ⏳ **Monorepo：** 即将转换（2-3天）
|
||||
4. ✅ **4种部署模式：** SaaS + 独立产品 + 单机版 + 私有化
|
||||
|
||||
---
|
||||
|
||||
## 📁 代码结构
|
||||
|
||||
```
|
||||
AIclinicalresearch/
|
||||
├── backend/ # Node.js + Fastify + Prisma
|
||||
├── frontend/ # React + Vite + Ant Design
|
||||
├── extraction_service/ # Python FastAPI微服务
|
||||
├── docs/ # 📖 文档（你在这里）
|
||||
└── docker-compose.yml # PostgreSQL + Redis
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 核心依赖
|
||||
|
||||
**LLM模型：**
|
||||
- DeepSeek-V3（主力，¥1/百万tokens）
|
||||
- Qwen3-72B（备用，¥5/百万tokens）
|
||||
- Qwen-Long（超长上下文，1M tokens）
|
||||
|
||||
**数据库：**
|
||||
- PostgreSQL 15（Docker部署）
|
||||
- Redis（缓存）
|
||||
- Dify（RAG向量数据库）
|
||||
|
||||
**已实现能力：**
|
||||
- ✅ 文档处理引擎（Python微服务）
|
||||
- ✅ RAG引擎（基于Dify）
|
||||
- ❌ LLM网关（待实现，P0优先级）
|
||||
|
||||
---
|
||||
|
||||
## 🚀 快速跳转（根据任务选择）
|
||||
|
||||
### 开发任务
|
||||
|
||||
**开发ASL模块：**
|
||||
→ 阅读 `03-业务模块/ASL-AI智能文献/[AI对接] ASL快速上下文.md`
|
||||
|
||||
**实现LLM网关：**
|
||||
→ 阅读 `02-通用能力层/01-LLM大模型网关/[AI对接] LLM网关快速上下文.md`
|
||||
|
||||
**开发运营管理端：**
|
||||
→ 阅读 `03-业务模块/ADMIN-运营管理端/README.md`
|
||||
|
||||
### 架构讨论
|
||||
|
||||
**了解整体架构：**
|
||||
→ 阅读 `00-系统总体设计/08-架构设计全景图.md`
|
||||
|
||||
**了解数据库架构：**
|
||||
→ 阅读 `00-系统总体设计/03-数据库架构说明.md`
|
||||
|
||||
**了解模块独立部署：**
|
||||
→ 阅读 `00-系统总体设计/06-模块独立部署与单机版方案.md`
|
||||
|
||||
### 了解现有系统
|
||||
|
||||
**了解已完成功能：**
|
||||
→ 阅读 `00-项目概述/现有系统技术摸底报告.md`
|
||||
|
||||
---
|
||||
|
||||
## 📖 常见任务快速指引
|
||||
|
||||
| 任务类型 | 需要阅读的文档（按顺序） | Token消耗 | 阅读时间 |
|
||||
|---------|----------------------|----------|---------|
|
||||
| **开发新模块** | 1. 本文档<br>2. 对应模块快速上下文<br>3. 模块PRD | ~3K | 5-8分钟 |
|
||||
| **修改已有功能** | 1. 本文档<br>2. 现有系统摸底报告<br>3. 具体模块文档 | ~5K | 10-15分钟 |
|
||||
| **架构讨论** | 1. 本文档<br>2. 架构设计全景图<br>3. 分层设计文档 | ~4K | 10分钟 |
|
||||
| **数据库修改** | 1. 本文档<br>2. 数据库架构说明<br>3. 具体模块数据库设计 | ~3K | 5-8分钟 |
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 关键提醒
|
||||
|
||||
**数据库：**
|
||||
- ✅ PostgreSQL在Docker中，不需要手动安装
|
||||
- ✅ 数据库名：`ai_clinical_research`
|
||||
- ✅ 连接：`localhost:5432`
|
||||
|
||||
**Dify：**
|
||||
- ✅ 独立系统，有自己的数据库
|
||||
- ✅ 通过API调用，不直接访问数据库
|
||||
|
||||
**文档状态：**
|
||||
- ⏳ 文档正在重构中（v3.0）
|
||||
- ✅ 新文档按三层架构组织
|
||||
- ✅ 每个层级都有快速上下文
|
||||
|
||||
---
|
||||
|
||||
## 📂 文档导航体系
|
||||
|
||||
```
|
||||
docs/
|
||||
├── 00-系统总体设计/ # 总体架构、技术决策
|
||||
├── 01-平台基础层/ # 用户权限、存储、通知
|
||||
├── 02-通用能力层/ # LLM网关、文档处理、RAG
|
||||
├── 03-业务模块/ # 8个独立业务模块
|
||||
├── 04-开发规范/ # API规范、数据库规范、代码规范
|
||||
├── 05-部署文档/ # 4种部署模式
|
||||
└── 08-项目管理/ # 开发计划、里程碑、每日进度
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 下一步行动（2025-11-06）
|
||||
|
||||
**本周计划：**
|
||||
1. 完成文档重构
|
||||
2. 创建快速上下文体系
|
||||
3. 准备ASL模块开发
|
||||
|
||||
**未来2-4周：**
|
||||
1. ASL模块开发（标题摘要初筛 + 全文复筛）
|
||||
2. LLM网关实现（P0，ASL依赖）
|
||||
|
||||
---
|
||||
|
||||
**最后更新：** 2025-11-06
|
||||
**维护人：** 技术架构师
|
||||
Reference in New Issue
Block a user