diff --git a/docs/00-系统总体设计/00-今日架构设计总结.md b/docs/00-系统总体设计/00-今日架构设计总结.md index 168eb6fd..0d636af2 100644 --- a/docs/00-系统总体设计/00-今日架构设计总结.md +++ b/docs/00-系统总体设计/00-今日架构设计总结.md @@ -521,3 +521,4 @@ ASL、DC、SSA、ST、RVW、ADMIN等模块： + diff --git a/docs/00-系统总体设计/00-核心问题解答.md b/docs/00-系统总体设计/00-核心问题解答.md index a5a9eaf6..32c77bac 100644 --- a/docs/00-系统总体设计/00-核心问题解答.md +++ b/docs/00-系统总体设计/00-核心问题解答.md @@ -696,3 +696,4 @@ P0文档（必须完成）： + diff --git a/docs/00-系统总体设计/00-阅读指南.md b/docs/00-系统总体设计/00-阅读指南.md index 847e1e89..0b909870 100644 --- a/docs/00-系统总体设计/00-阅读指南.md +++ b/docs/00-系统总体设计/00-阅读指南.md @@ -172,3 +172,4 @@ + diff --git a/docs/00-系统总体设计/01-系统架构分层设计.md b/docs/00-系统总体设计/01-系统架构分层设计.md index 76038f98..0e445f2d 100644 --- a/docs/00-系统总体设计/01-系统架构分层设计.md +++ b/docs/00-系统总体设计/01-系统架构分层设计.md @@ -170,7 +170,168 @@ const url = await storage.upload('literature/123.pdf', pdfBuffer) - ✅ 所有模块复用同一套代码 - ✅ 支持PRD定义的4种部署形态 -**实施文档：** [平台基础设施规划](../09-架构实施/04-平台基础设施规划.md) +**实施状态：** ✅ 2025-11-17 完成（LocalAdapter + OSSAdapter预留） + +**实施文档：** +- [平台基础设施规划](../09-架构实施/04-平台基础设施规划.md) +- [backend/src/common/README.md](../../backend/src/common/README.md) +- [平台基础设施实施完成报告](../08-项目管理/03-每周计划/2025-11-17-平台基础设施实施完成报告.md) + +--- + +#### 2.1. 日志系统（Logging Service）⭐ 2025-11-17 新增 + +**职责：** +- 结构化日志输出（JSON格式） +- 支持本地开发和云端部署 +- 集成阿里云SLS（生产环境） + +**实现方式：** + +```typescript +// Winston配置 +import { logger } from '@/common/logging' + +// 基础日志 +logger.info('User logged in', { userId: 123 }) +logger.error('Database error', { error: err.message }) + +// 带上下文的日志 +const aslLogger = logger.child({ module: 'ASL', projectId: 456 }) +aslLogger.info('Screening started', { count: 100 }) +``` + +**输出格式：** +- 本地开发：彩色可读格式 +- 生产环境：JSON格式（便于SLS解析） + +**实施状态：** ✅ 2025-11-17 完成（需安装winston依赖） + +--- + +#### 2.2. 缓存服务（Cache Service）⭐ 2025-11-17 新增 + +**职责：** +- LLM响应缓存（减少API调用成本） +- 数据库查询结果缓存 +- Session缓存 + +**实现方式：** + +```typescript +// 适配器模式：MemoryCacheAdapter | RedisCacheAdapter +import { cache } from '@/common/cache' + +// 缓存LLM响应（1小时） +const cacheKey = `llm:${model}:${hash(prompt)}` +await cache.set(cacheKey, response, 60 * 60) +const cached = await cache.get(cacheKey) +``` + +**环境切换：** +- 本地开发：`CACHE_TYPE=memory` +- 云端部署：`CACHE_TYPE=redis` + +**实施状态：** ✅ 2025-11-17 完成（MemoryCache + RedisCache预留） + +--- + +#### 2.3. 异步任务（Job Queue）⭐ 2025-11-17 新增 + +**职责：** +- 长时间任务异步处理（避免Serverless超时） +- 任务进度查询 +- 支持任务重试和失败处理 + +**实现方式：** + +```typescript +import { jobQueue } from '@/common/jobs' + +// 创建任务（立即返回） +const job = await jobQueue.push('asl:screening', { + projectId: 123, + literatureIds: [1, 2, 3] +}) + +// 返回任务ID给前端 +res.send({ jobId: job.id }) + +// 前端轮询任务状态 +const status = await jobQueue.getJob(job.id) +// { status: 'processing', progress: 45 } +``` + +**环境切换：** +- 本地开发：`QUEUE_TYPE=memory` +- 云端部署：`QUEUE_TYPE=database` + +**实施状态：** ✅ 2025-11-17 完成（MemoryQueue + DatabaseQueue预留） + +--- + +#### 2.4. 健康检查（Health Check）⭐ 2025-11-17 新增 + +**职责：** +- SAE存活检查（Liveness Probe） +- SAE就绪检查（Readiness Probe） +- 数据库连接监控 + +**端点：** +- `GET /health/liveness` - 简单响应 +- `GET /health/readiness` - 检查数据库、内存等 +- `GET /health` - 详细健康信息（开发用） + +**实施状态：** ✅ 2025-11-17 完成 + +--- + +#### 2.5. 监控指标（Monitoring）⭐ 2025-11-17 新增 + +**职责：** +- 数据库连接数监控（带告警） +- 内存使用监控（带告警） +- API响应时间监控 +- LLM调用统计 + +**使用方式：** + +```typescript +import { Metrics } from '@/common/monitoring' + +// 记录数据库连接数（带告警） +await Metrics.recordDBConnectionCount() + +// 记录API响应时间 +Metrics.recordAPIResponseTime('GET', '/api/projects', 200, 150) + +// 记录LLM调用 +Metrics.recordLLMCall('deepseek', 'chat', 1500, true, { total: 300 }) +``` + +**实施状态：** ✅ 2025-11-17 完成 + +--- + +#### 2.6. 数据库连接池（Connection Pool）⭐ 2025-11-17 新增 + +**职责：** +- 防止Serverless扩容导致连接数超限 +- 优雅关闭连接（SIGTERM信号处理） +- 连接数监控 + +**配置：** + +```bash +# 动态连接限制计算 +# connectionLimit = (RDS_MAX_CONNECTIONS / MAX_INSTANCES) - 预留 + +DB_MAX_CONNECTIONS=400 # RDS最大连接数 +MAX_INSTANCES=20 # SAE最大实例数 +# 每实例推荐：18个连接 +``` + +**实施状态：** ✅ 2025-11-17 完成 --- diff --git a/docs/00-系统总体设计/03-数据库架构说明.md b/docs/00-系统总体设计/03-数据库架构说明.md index a24aa91a..e66d45a0 100644 --- a/docs/00-系统总体设计/03-数据库架构说明.md +++ b/docs/00-系统总体设计/03-数据库架构说明.md @@ -445,3 +445,4 @@ await fetch(`http://localhost/v1/datasets/${datasetId}/document/create-by-file`, + diff --git a/docs/00-系统总体设计/04-运营管理端架构设计.md b/docs/00-系统总体设计/04-运营管理端架构设计.md index 7bdbaaf4..dbd05608 100644 --- a/docs/00-系统总体设计/04-运营管理端架构设计.md +++ b/docs/00-系统总体设计/04-运营管理端架构设计.md @@ -870,3 +870,4 @@ backend/src/admin/ + diff --git a/docs/00-系统总体设计/05-Schema隔离方案与成本分析.md b/docs/00-系统总体设计/05-Schema隔离方案与成本分析.md index b634ac1e..cfd3e089 100644 --- a/docs/00-系统总体设计/05-Schema隔离方案与成本分析.md +++ b/docs/00-系统总体设计/05-Schema隔离方案与成本分析.md @@ -1053,3 +1053,4 @@ async function testSchemaIsolation() { + diff --git a/docs/00-系统总体设计/06-模块独立部署与单机版方案.md b/docs/00-系统总体设计/06-模块独立部署与单机版方案.md index dd3fc1a1..d67f690a 100644 --- a/docs/00-系统总体设计/06-模块独立部署与单机版方案.md +++ b/docs/00-系统总体设计/06-模块独立部署与单机版方案.md @@ -1552,3 +1552,4 @@ export function setupAutoUpdater() { + diff --git a/docs/00-系统总体设计/07-Monorepo架构评估.md b/docs/00-系统总体设计/07-Monorepo架构评估.md index 5de1ad39..a9dbc404 100644 --- a/docs/00-系统总体设计/07-Monorepo架构评估.md +++ b/docs/00-系统总体设计/07-Monorepo架构评估.md @@ -566,3 +566,4 @@ git reset --hard HEAD + diff --git a/docs/00-系统总体设计/08-架构设计全景图.md b/docs/00-系统总体设计/08-架构设计全景图.md index d7cbf519..f9c37b89 100644 --- a/docs/00-系统总体设计/08-架构设计全景图.md +++ b/docs/00-系统总体设计/08-架构设计全景图.md @@ -682,3 +682,4 @@ Week 7-8（第7-8周）：运营管理端P0功能 + diff --git a/docs/00-系统总体设计/09-总体需求文档(PRD).md b/docs/00-系统总体设计/09-总体需求文档(PRD).md index 07d64cd3..1009c27f 100644 --- a/docs/00-系统总体设计/09-总体需求文档(PRD).md +++ b/docs/00-系统总体设计/09-总体需求文档(PRD).md @@ -97,3 +97,4 @@ + diff --git a/docs/00-系统总体设计/10-核心业务规则总览.md b/docs/00-系统总体设计/10-核心业务规则总览.md index 3d92736f..b8831e72 100644 --- a/docs/00-系统总体设计/10-核心业务规则总览.md +++ b/docs/00-系统总体设计/10-核心业务规则总览.md @@ -605,3 +605,4 @@ + diff --git a/docs/00-系统总体设计/99-下一步行动决策建议.md b/docs/00-系统总体设计/99-下一步行动决策建议.md index 3d961a4e..842757bd 100644 --- a/docs/00-系统总体设计/99-下一步行动决策建议.md +++ b/docs/00-系统总体设计/99-下一步行动决策建议.md @@ -628,3 +628,4 @@ Day 6（测试验证）： + diff --git a/docs/00-系统总体设计/[AI对接] 快速上下文.md b/docs/00-系统总体设计/[AI对接] 快速上下文.md index 9033c004..fc85eba8 100644 --- a/docs/00-系统总体设计/[AI对接] 快速上下文.md +++ b/docs/00-系统总体设计/[AI对接] 快速上下文.md @@ -17,10 +17,13 @@ ## 📊 核心信息卡片 ### 项目状态 -- **当前阶段：** 架构设计完成，文档重构中 -- **已完成：** AIA(AI问答)、PKB(知识库)、RVW(审稿)核心功能 -- **下一步：** ASL(AI智能文献)模块开发 -- **技术栈：** Node.js + React + PostgreSQL + Python微服务 +- **当前阶段：** ✅ 平台基础设施完成，准备ASL模块开发 +- **已完成：** + - AIA(AI问答)、PKB(知识库)、RVW(审稿)核心功能 + - ⭐ 平台基础设施（2025-11-17）：8个云原生模块 + - Schema隔离、前后端模块化架构 +- **下一步：** ASL(AI智能文献)模块开发（使用平台基础设施） +- **技术栈：** Node.js + React + PostgreSQL + Python微服务 + 云原生架构 ### 8个业务模块（优先级排序） @@ -37,9 +40,38 @@ ### 关键架构决策 1. ✅ **三层架构：** 平台层 + 通用能力层 + 业务模块层 -2. ⏳ **Schema隔离：** 即将实施（1周） -3. ⏳ **Monorepo：** 即将转换（2-3天） -4. ✅ **4种部署模式：** SaaS + 独立产品 + 单机版 + 私有化 +2. ✅ **Schema隔离：** 已完成（10个Schema） +3. ✅ **前后端模块化：** Frontend-v2 + Backend分层架构 +4. ✅ **平台基础设施：** ⭐ 2025-11-17 新增 - 云原生基础能力 +5. ✅ **4种部署模式：** SaaS + 独立产品 + 单机版 + 私有化 + +### ⭐ 平台基础设施（2025-11-17 新增） + +**8个核心模块（全部完成）：** +- ✅ **存储服务**：本地/OSS零代码切换 +- ✅ **数据库连接池**：防止Serverless连接数超限 +- ✅ **日志系统**：Winston+JSON格式 +- ✅ **缓存服务**：内存/Redis切换 +- ✅ **异步任务**：避免超时 +- ✅ **健康检查**：SAE探测 +- ✅ **监控指标**：数据库/内存/API监控 +- ✅ **环境配置**：统一管理 + +**设计原则：** 适配器模式实现本地开发和云端部署零代码切换 + +**使用示例：** +```typescript +import { storage, logger, cache, jobQueue } from '@/common' + +// 零代码环境切换 +await storage.upload('file.pdf', buffer) // local/oss +await cache.set('key', value, 3600) // memory/redis +const job = await jobQueue.push('task', data) // memory/database +``` + +**详细文档：** +- [平台基础设施规划](../09-架构实施/04-平台基础设施规划.md) +- [backend/src/common/README.md](../../backend/src/common/README.md) --- diff --git a/docs/00-系统总体设计/[重要] 2025-11-06 架构设计完成报告.md b/docs/00-系统总体设计/[重要] 2025-11-06 架构设计完成报告.md index 068125af..872798eb 100644 --- a/docs/00-系统总体设计/[重要] 2025-11-06 架构设计完成报告.md +++ b/docs/00-系统总体设计/[重要] 2025-11-06 架构设计完成报告.md @@ -552,3 +552,4 @@ RAG引擎：43%（3/7模块依赖） + diff --git a/docs/00-系统总体设计/前后端模块化架构设计-V2.md b/docs/00-系统总体设计/前后端模块化架构设计-V2.md index 80327a64..11ed0e3b 100644 --- a/docs/00-系统总体设计/前后端模块化架构设计-V2.md +++ b/docs/00-系统总体设计/前后端模块化架构设计-V2.md @@ -554,6 +554,210 @@ Schema数量: 10个（3详细 + 7占位） --- +## ⚙️ 平台基础设施（2025-11-17 新增）✅ + +> **⭐ 重要提示：平台基础设施提供云原生的通用能力，所有业务模块直接复用** +> **详细规划：** 参见 [平台基础设施规划](../09-架构实施/04-平台基础设施规划.md) +> **使用指南：** 参见 [backend/src/common/README.md](../../backend/src/common/README.md) +> **开发规范：** 参见 [云原生开发规范](../04-开发规范/08-云原生开发规范.md) + +--- + +### 🎯 设计目标 + +**核心原则：** 通过**适配器模式（Adapter Pattern）**实现本地开发和云端部署零代码切换 + +``` +┌─────────────────────────────────────────────────────────┐ +│ 业务模块层 │ +│ ASL | AIA | PKB | DC | SSA | ST | UAM │ +│ 只关注业务逻辑，复用平台能力 │ +└─────────────────────────────────────────────────────────┘ + ↓ import from '@/common/' +┌─────────────────────────────────────────────────────────┐ +│ 平台基础设施层（Adapter Pattern） │ +├─────────────────────────────────────────────────────────┤ +│ 存储：LocalAdapter ←→ OSSAdapter │ +│ 缓存：MemoryCacheAdapter ←→ RedisCacheAdapter │ +│ 任务：MemoryQueueAdapter ←→ DatabaseQueueAdapter │ +│ 日志：ConsoleLogger ←→ 阿里云SLS │ +│ 数据库：本地PostgreSQL ←→ 阿里云RDS（连接池） │ +└─────────────────────────────────────────────────────────┘ + ↓ 环境变量切换 +┌─────────────────────────────────────────────────────────┐ +│ 部署环境（零代码改动） │ +│ 本地开发 | 云端SaaS | 私有化部署 | 单机版 │ +└─────────────────────────────────────────────────────────┘ +``` + +--- + +### 📦 核心模块清单 + +| 模块 | 路径 | 状态 | 说明 | 环境切换 | +|------|------|------|------|---------| +| **存储服务** | `common/storage/` | ✅ 完成 | 文件上传下载 | `STORAGE_TYPE=local/oss` | +| **数据库连接池** | `config/database.ts` | ✅ 完成 | Prisma连接池 | `DATABASE_URL` | +| **日志系统** | `common/logging/` | ✅ 完成 | 结构化日志 | 自动切换（根据NODE_ENV） | +| **环境配置** | `config/env.ts` | ✅ 完成 | 统一配置管理 | `.env`文件或环境变量 | +| **异步任务** | `common/jobs/` | ✅ 完成 | 长时间任务处理 | `QUEUE_TYPE=memory/database` | +| **缓存服务** | `common/cache/` | ✅ 完成 | 内存/Redis缓存 | `CACHE_TYPE=memory/redis` | +| **健康检查** | `common/health/` | ✅ 完成 | SAE健康检查 | N/A | +| **监控指标** | `common/monitoring/` | ✅ 完成 | 关键指标监控 | N/A | + +--- + +### 💻 使用示例 + +#### **1. 存储服务（零代码切换）** + +```typescript +import { storage } from '@/common/storage' + +// 业务代码（完全相同） +const buffer = await readFile('example.pdf') +const url = await storage.upload('literature/123.pdf', buffer) + +// 环境切换： +// 本地开发：STORAGE_TYPE=local → 存储到 backend/uploads/ +// 云端部署：STORAGE_TYPE=oss → 存储到阿里云OSS +``` + +#### **2. 日志系统（结构化日志）** + +```typescript +import { logger } from '@/common/logging' + +// 基础日志 +logger.info('User logged in', { userId: 123 }) +logger.error('Database error', { error: err.message }) + +// 带上下文的日志 +const aslLogger = logger.child({ module: 'ASL', projectId: 456 }) +aslLogger.info('Screening started', { count: 100 }) + +// 输出格式： +// 本地开发：彩色可读格式 +// 生产环境：JSON格式（便于阿里云SLS解析） +``` + +#### **3. 异步任务（避免Serverless超时）** + +```typescript +import { jobQueue } from '@/common/jobs' + +// 创建任务（立即返回） +const job = await jobQueue.push('asl:screening', { + projectId: 123, + literatureIds: [1, 2, 3] +}) + +// 返回任务ID给前端 +res.send({ jobId: job.id }) + +// 前端轮询任务状态 +const status = await jobQueue.getJob(job.id) +// { status: 'processing', progress: 45 } +``` + +#### **4. 缓存服务（减少LLM调用成本）** + +```typescript +import { cache } from '@/common/cache' + +// 缓存LLM响应（1小时） +const cacheKey = `llm:${model}:${hash(prompt)}` +const cached = await cache.get(cacheKey) + +if (!cached) { + const response = await llm.chat(prompt) + await cache.set(cacheKey, response, 60 * 60) + return response +} + +return cached +``` + +--- + +### 🌍 多环境配置 + +#### **本地开发（.env.development）** + +```bash +# 存储：本地文件系统 +STORAGE_TYPE=local +LOCAL_STORAGE_DIR=uploads + +# 缓存：内存缓存 +CACHE_TYPE=memory + +# 任务队列：内存队列 +QUEUE_TYPE=memory + +# 日志：彩色输出 +LOG_LEVEL=debug +``` + +#### **云端部署（.env.production）** + +```bash +# 存储：阿里云OSS +STORAGE_TYPE=oss +OSS_REGION=oss-cn-hangzhou +OSS_BUCKET=aiclinical-prod +OSS_ACCESS_KEY_ID=your-key-id +OSS_ACCESS_KEY_SECRET=your-key-secret + +# 缓存：阿里云Redis +CACHE_TYPE=redis +REDIS_HOST=r-xxx.redis.aliyuncs.com +REDIS_PORT=6379 +REDIS_PASSWORD=your-password + +# 任务队列：数据库队列 +QUEUE_TYPE=database + +# 日志：JSON输出 +LOG_LEVEL=info +``` + +--- + +### ⚠️ 重要注意事项 + +#### **1. Winston依赖未安装** + +```bash +# 需要安装 +cd backend +npm install winston +npm install -D @types/winston +``` + +#### **2. Legacy模块兼容性** + +- ✅ **Legacy模块**（PKB、AIA、DC）保持现状，正常运行 +- ✅ **新模块**（ASL）使用平台基础设施 +- 🔄 **可选迁移**：Legacy模块按需迁移（预计5小时） + +#### **3. 云端实现预留** + +- `OSSAdapter`、`RedisCacheAdapter` 当前为预留实现 +- 云端部署前需安装依赖并取消注释 +- 详见实施文档 + +--- + +### 📚 相关文档 + +- **详细规划：** [平台基础设施规划](../09-架构实施/04-平台基础设施规划.md) +- **使用指南：** [backend/src/common/README.md](../../backend/src/common/README.md) +- **实施报告：** [2025-11-17-平台基础设施实施完成报告](../08-项目管理/03-每周计划/2025-11-17-平台基础设施实施完成报告.md) +- **开发规范：** [云原生开发规范](../04-开发规范/08-云原生开发规范.md) + +--- + ## 🌥️ 云原生部署架构（2025-11-16 新增） > **⭐ 重要提示：本章节定义平台的云原生部署策略，适用于所有业务模块** diff --git a/docs/00-项目概述/文档梳理与差异分析.md b/docs/00-项目概述/文档梳理与差异分析.md index a7280f4c..5e6a0484 100644 --- a/docs/00-项目概述/文档梳理与差异分析.md +++ b/docs/00-项目概述/文档梳理与差异分析.md @@ -496,3 +496,4 @@ F1. 智能统计分析 (SSA)： + diff --git a/docs/00-项目概述/最新需求与技术方案深度评估.md b/docs/00-项目概述/最新需求与技术方案深度评估.md index 9fa93f92..2d0f9f64 100644 --- a/docs/00-项目概述/最新需求与技术方案深度评估.md +++ b/docs/00-项目概述/最新需求与技术方案深度评估.md @@ -1346,3 +1346,4 @@ P3：K8s、Electron、私有化（阶段二） + diff --git a/docs/00-项目概述/现有系统技术摸底报告.md b/docs/00-项目概述/现有系统技术摸底报告.md index 0f0b24bf..cbaf3dc3 100644 --- a/docs/00-项目概述/现有系统技术摸底报告.md +++ b/docs/00-项目概述/现有系统技术摸底报告.md @@ -1602,3 +1602,4 @@ batchService.executeBatchTask() + diff --git a/docs/00-项目概述/系统总体架构设计.md b/docs/00-项目概述/系统总体架构设计.md index 46437ffa..897896f1 100644 --- a/docs/00-项目概述/系统总体架构设计.md +++ b/docs/00-项目概述/系统总体架构设计.md @@ -46,5 +46,6 @@ + diff --git a/docs/01-平台基础层/01-用户与权限中心(UAM)/README.md b/docs/01-平台基础层/01-用户与权限中心(UAM)/README.md index 8f2ea19c..b46ac243 100644 --- a/docs/01-平台基础层/01-用户与权限中心(UAM)/README.md +++ b/docs/01-平台基础层/01-用户与权限中心(UAM)/README.md @@ -83,3 +83,4 @@ + diff --git a/docs/01-平台基础层/02-存储服务/README.md b/docs/01-平台基础层/02-存储服务/README.md index 1f5a3de3..8dba246a 100644 --- a/docs/01-平台基础层/02-存储服务/README.md +++ b/docs/01-平台基础层/02-存储服务/README.md @@ -63,3 +63,4 @@ + diff --git a/docs/01-平台基础层/03-通知服务/README.md b/docs/01-平台基础层/03-通知服务/README.md index 71df2677..e921d5d7 100644 --- a/docs/01-平台基础层/03-通知服务/README.md +++ b/docs/01-平台基础层/03-通知服务/README.md @@ -49,3 +49,4 @@ + diff --git a/docs/01-平台基础层/04-监控与日志/README.md b/docs/01-平台基础层/04-监控与日志/README.md index 8742500a..ed0da042 100644 --- a/docs/01-平台基础层/04-监控与日志/README.md +++ b/docs/01-平台基础层/04-监控与日志/README.md @@ -49,3 +49,4 @@ + diff --git a/docs/01-平台基础层/05-系统配置/README.md b/docs/01-平台基础层/05-系统配置/README.md index b812ae3d..0a91bcce 100644 --- a/docs/01-平台基础层/05-系统配置/README.md +++ b/docs/01-平台基础层/05-系统配置/README.md @@ -45,3 +45,4 @@ + diff --git a/docs/01-平台基础层/06-前端架构/01-前端总体架构设计.md b/docs/01-平台基础层/06-前端架构/01-前端总体架构设计.md index e0026823..bce6c762 100644 --- a/docs/01-平台基础层/06-前端架构/01-前端总体架构设计.md +++ b/docs/01-平台基础层/06-前端架构/01-前端总体架构设计.md @@ -575,3 +575,4 @@ export const ModuleLayout = ({ module }: { module: ModuleDefinition }) => { + diff --git a/docs/01-平台基础层/06-前端架构/02-导航结构设计.md b/docs/01-平台基础层/06-前端架构/02-导航结构设计.md index 0df9730e..2f49c29d 100644 --- a/docs/01-平台基础层/06-前端架构/02-导航结构设计.md +++ b/docs/01-平台基础层/06-前端架构/02-导航结构设计.md @@ -388,3 +388,4 @@ const handleSideNavClick = (item: SideNavItem) => { + diff --git a/docs/01-平台基础层/06-前端架构/03-架构原型图.html b/docs/01-平台基础层/06-前端架构/03-架构原型图.html index 458c1943..f09f55c5 100644 --- a/docs/01-平台基础层/06-前端架构/03-架构原型图.html +++ b/docs/01-平台基础层/06-前端架构/03-架构原型图.html @@ -304,3 +304,4 @@ + diff --git a/docs/01-平台基础层/06-前端架构/README.md b/docs/01-平台基础层/06-前端架构/README.md index 5a961548..9c93ac70 100644 --- a/docs/01-平台基础层/06-前端架构/README.md +++ b/docs/01-平台基础层/06-前端架构/README.md @@ -53,3 +53,4 @@ + diff --git a/docs/01-平台基础层/README.md b/docs/01-平台基础层/README.md index 1179fa98..fec9a977 100644 --- a/docs/01-平台基础层/README.md +++ b/docs/01-平台基础层/README.md @@ -76,3 +76,4 @@ + diff --git a/docs/01-平台基础层/[AI对接] 平台层快速上下文.md b/docs/01-平台基础层/[AI对接] 平台层快速上下文.md index 955932be..2016a1e5 100644 --- a/docs/01-平台基础层/[AI对接] 平台层快速上下文.md +++ b/docs/01-平台基础层/[AI对接] 平台层快速上下文.md @@ -133,3 +133,4 @@ Feature Flag = 商业模式技术基础 + diff --git a/docs/02-通用能力层/01-LLM大模型网关/03-CloseAI集成指南.md b/docs/02-通用能力层/01-LLM大模型网关/03-CloseAI集成指南.md index fdb72a41..e9325310 100644 --- a/docs/02-通用能力层/01-LLM大模型网关/03-CloseAI集成指南.md +++ b/docs/02-通用能力层/01-LLM大模型网关/03-CloseAI集成指南.md @@ -522,3 +522,4 @@ async chatWithRetry(provider: LLMProvider, prompt: string, maxRetries = 3) { + diff --git a/docs/02-通用能力层/01-LLM大模型网关/[AI对接] LLM网关快速上下文.md b/docs/02-通用能力层/01-LLM大模型网关/[AI对接] LLM网关快速上下文.md index 6ab3f769..4c725c47 100644 --- a/docs/02-通用能力层/01-LLM大模型网关/[AI对接] LLM网关快速上下文.md +++ b/docs/02-通用能力层/01-LLM大模型网关/[AI对接] LLM网关快速上下文.md @@ -533,3 +533,4 @@ function estimateTokens(text: string, model: string): number { + diff --git a/docs/02-通用能力层/02-文档处理引擎/README.md b/docs/02-通用能力层/02-文档处理引擎/README.md index a1159641..430fc074 100644 --- a/docs/02-通用能力层/02-文档处理引擎/README.md +++ b/docs/02-通用能力层/02-文档处理引擎/README.md @@ -105,3 +105,4 @@ GET /health - 健康检查 + diff --git a/docs/02-通用能力层/03-RAG引擎/README.md b/docs/02-通用能力层/03-RAG引擎/README.md index 9df6eb5a..77f19632 100644 --- a/docs/02-通用能力层/03-RAG引擎/README.md +++ b/docs/02-通用能力层/03-RAG引擎/README.md @@ -100,3 +100,4 @@ interface RAGEngine { + diff --git a/docs/02-通用能力层/04-数据ETL引擎/README.md b/docs/02-通用能力层/04-数据ETL引擎/README.md index 6b9b01d0..bc624156 100644 --- a/docs/02-通用能力层/04-数据ETL引擎/README.md +++ b/docs/02-通用能力层/04-数据ETL引擎/README.md @@ -86,3 +86,4 @@ class ETLEngine: + diff --git a/docs/02-通用能力层/05-医学NLP引擎/README.md b/docs/02-通用能力层/05-医学NLP引擎/README.md index f1fbd685..3e1af499 100644 --- a/docs/02-通用能力层/05-医学NLP引擎/README.md +++ b/docs/02-通用能力层/05-医学NLP引擎/README.md @@ -80,3 +80,4 @@ + diff --git a/docs/02-通用能力层/README.md b/docs/02-通用能力层/README.md index db306435..990c3a5d 100644 --- a/docs/02-通用能力层/README.md +++ b/docs/02-通用能力层/README.md @@ -93,3 +93,4 @@ + diff --git a/docs/02-通用能力层/[AI对接] 通用能力快速上下文.md b/docs/02-通用能力层/[AI对接] 通用能力快速上下文.md index f64c22b4..77e2b71c 100644 --- a/docs/02-通用能力层/[AI对接] 通用能力快速上下文.md +++ b/docs/02-通用能力层/[AI对接] 通用能力快速上下文.md @@ -178,3 +178,4 @@ + diff --git a/docs/03-业务模块/ADMIN-运营管理端/README.md b/docs/03-业务模块/ADMIN-运营管理端/README.md index 115ef42c..ff8c4dd0 100644 --- a/docs/03-业务模块/ADMIN-运营管理端/README.md +++ b/docs/03-业务模块/ADMIN-运营管理端/README.md @@ -99,3 +99,4 @@ ADMIN-运营管理端/ + diff --git a/docs/03-业务模块/ADMIN-运营管理端/[AI对接] ADMIN快速上下文.md b/docs/03-业务模块/ADMIN-运营管理端/[AI对接] ADMIN快速上下文.md index 124801d3..307a4d29 100644 --- a/docs/03-业务模块/ADMIN-运营管理端/[AI对接] ADMIN快速上下文.md +++ b/docs/03-业务模块/ADMIN-运营管理端/[AI对接] ADMIN快速上下文.md @@ -502,3 +502,4 @@ async function getOverviewReport() { + diff --git a/docs/03-业务模块/AIA-AI智能问答/02-技术设计/01-数据库设计.md b/docs/03-业务模块/AIA-AI智能问答/02-技术设计/01-数据库设计.md index 684786e4..6a1f9d80 100644 --- a/docs/03-业务模块/AIA-AI智能问答/02-技术设计/01-数据库设计.md +++ b/docs/03-业务模块/AIA-AI智能问答/02-技术设计/01-数据库设计.md @@ -525,3 +525,4 @@ id String @id @default(uuid()) + diff --git a/docs/03-业务模块/AIA-AI智能问答/README.md b/docs/03-业务模块/AIA-AI智能问答/README.md index 448dedbd..c70848d6 100644 --- a/docs/03-业务模块/AIA-AI智能问答/README.md +++ b/docs/03-业务模块/AIA-AI智能问答/README.md @@ -68,3 +68,4 @@ AIA-AI智能问答/ + diff --git a/docs/03-业务模块/ASL-AI智能文献/README.md b/docs/03-业务模块/ASL-AI智能文献/README.md index 00db22e9..7c16b28e 100644 --- a/docs/03-业务模块/ASL-AI智能文献/README.md +++ b/docs/03-业务模块/ASL-AI智能文献/README.md @@ -80,3 +80,4 @@ ASL-AI智能文献/ + diff --git a/docs/03-业务模块/ASL-AI智能文献/[AI对接] ASL快速上下文.md b/docs/03-业务模块/ASL-AI智能文献/[AI对接] ASL快速上下文.md index 970e08b1..7239b5e0 100644 --- a/docs/03-业务模块/ASL-AI智能文献/[AI对接] ASL快速上下文.md +++ b/docs/03-业务模块/ASL-AI智能文献/[AI对接] ASL快速上下文.md @@ -319,3 +319,4 @@ A: 降级策略：Nougat → PyMuPDF → 提示用户手动处理 + diff --git a/docs/03-业务模块/ASL-AI智能文献/[AI对接] ASL模块快速上下文.md b/docs/03-业务模块/ASL-AI智能文献/[AI对接] ASL模块快速上下文.md index 521f8162..51ec5d68 100644 --- a/docs/03-业务模块/ASL-AI智能文献/[AI对接] ASL模块快速上下文.md +++ b/docs/03-业务模块/ASL-AI智能文献/[AI对接] ASL模块快速上下文.md @@ -414,3 +414,4 @@ A：✅ T1.1.1 - 在 `backend/prisma/schema.prisma` 中定义4个模型 **🎉 祝开发顺利！从 T1.1.1 开始吧！** + diff --git a/docs/03-业务模块/DC-数据清洗整理/README.md b/docs/03-业务模块/DC-数据清洗整理/README.md index 8b28d412..b4f732f6 100644 --- a/docs/03-业务模块/DC-数据清洗整理/README.md +++ b/docs/03-业务模块/DC-数据清洗整理/README.md @@ -96,3 +96,4 @@ DC-数据清洗整理/ + diff --git a/docs/03-业务模块/PKB-个人知识库/02-技术设计/01-数据库设计.md b/docs/03-业务模块/PKB-个人知识库/02-技术设计/01-数据库设计.md index 255e5ed1..514b2458 100644 --- a/docs/03-业务模块/PKB-个人知识库/02-技术设计/01-数据库设计.md +++ b/docs/03-业务模块/PKB-个人知识库/02-技术设计/01-数据库设计.md @@ -594,3 +594,4 @@ sequenceDiagram + diff --git a/docs/03-业务模块/PKB-个人知识库/README.md b/docs/03-业务模块/PKB-个人知识库/README.md index bcb73a48..f918cfc2 100644 --- a/docs/03-业务模块/PKB-个人知识库/README.md +++ b/docs/03-业务模块/PKB-个人知识库/README.md @@ -60,3 +60,4 @@ PKB-个人知识库/ + diff --git a/docs/03-业务模块/README.md b/docs/03-业务模块/README.md index 26b422d2..0017f0ae 100644 --- a/docs/03-业务模块/README.md +++ b/docs/03-业务模块/README.md @@ -117,3 +117,4 @@ + diff --git a/docs/03-业务模块/RVW-稿件审查系统/README.md b/docs/03-业务模块/RVW-稿件审查系统/README.md index 1fe62a1b..a5f0902b 100644 --- a/docs/03-业务模块/RVW-稿件审查系统/README.md +++ b/docs/03-业务模块/RVW-稿件审查系统/README.md @@ -93,3 +93,4 @@ RVW-稿件审查系统/ + diff --git a/docs/03-业务模块/SSA-智能统计分析/README.md b/docs/03-业务模块/SSA-智能统计分析/README.md index 88fef9d8..f78287b2 100644 --- a/docs/03-业务模块/SSA-智能统计分析/README.md +++ b/docs/03-业务模块/SSA-智能统计分析/README.md @@ -82,3 +82,4 @@ SSA-智能统计分析/ + diff --git a/docs/03-业务模块/ST-统计分析工具/README.md b/docs/03-业务模块/ST-统计分析工具/README.md index c551c646..bbc5afc3 100644 --- a/docs/03-业务模块/ST-统计分析工具/README.md +++ b/docs/03-业务模块/ST-统计分析工具/README.md @@ -80,3 +80,4 @@ ST-统计分析工具/ + diff --git a/docs/03-业务模块/[AI对接] 业务模块快速上下文.md b/docs/03-业务模块/[AI对接] 业务模块快速上下文.md index 3fdb76e7..a300cb1d 100644 --- a/docs/03-业务模块/[AI对接] 业务模块快速上下文.md +++ b/docs/03-业务模块/[AI对接] 业务模块快速上下文.md @@ -171,3 +171,4 @@ + diff --git a/docs/04-开发规范/01-数据库设计规范.md b/docs/04-开发规范/01-数据库设计规范.md index 817499eb..d32c00f6 100644 --- a/docs/04-开发规范/01-数据库设计规范.md +++ b/docs/04-开发规范/01-数据库设计规范.md @@ -495,3 +495,4 @@ content TEXT -- 内容 + diff --git a/docs/04-开发规范/02-API设计规范.md b/docs/04-开发规范/02-API设计规范.md index 3417d9c5..0d0a9a15 100644 --- a/docs/04-开发规范/02-API设计规范.md +++ b/docs/04-开发规范/02-API设计规范.md @@ -525,3 +525,4 @@ If-None-Match: "33a64df551425fcc55e4d42a148795d9f25f89d4" + diff --git a/docs/04-开发规范/03-数据库全局视图.md b/docs/04-开发规范/03-数据库全局视图.md index 883e346f..1497f561 100644 --- a/docs/04-开发规范/03-数据库全局视图.md +++ b/docs/04-开发规范/03-数据库全局视图.md @@ -347,3 +347,4 @@ CREATE TABLE ssa_schema.analysis_projects ( + diff --git a/docs/04-开发规范/04-API路由总览.md b/docs/04-开发规范/04-API路由总览.md index 2890f946..23688855 100644 --- a/docs/04-开发规范/04-API路由总览.md +++ b/docs/04-开发规范/04-API路由总览.md @@ -391,3 +391,4 @@ + diff --git a/docs/04-开发规范/06-Git提交规范.md b/docs/04-开发规范/06-Git提交规范.md index 0c1f5b00..bc2ca611 100644 --- a/docs/04-开发规范/06-Git提交规范.md +++ b/docs/04-开发规范/06-Git提交规范.md @@ -855,3 +855,4 @@ git push-current # 推送当前分支 **版本历史：** - v1.0 (2025-11-16): 初始版本，包含完整的 Git 规范和中文乱码解决方案 + diff --git a/docs/05-部署文档/01-部署架构设计.md b/docs/05-部署文档/01-部署架构设计.md index fd2d5476..be6026d4 100644 --- a/docs/05-部署文档/01-部署架构设计.md +++ b/docs/05-部署文档/01-部署架构设计.md @@ -38,3 +38,4 @@ + diff --git a/docs/05-部署文档/README.md b/docs/05-部署文档/README.md index 9df47b6e..91f61a5c 100644 --- a/docs/05-部署文档/README.md +++ b/docs/05-部署文档/README.md @@ -60,3 +60,4 @@ + diff --git a/docs/06-测试文档/README.md b/docs/06-测试文档/README.md index 312eb6ae..33df49aa 100644 --- a/docs/06-测试文档/README.md +++ b/docs/06-测试文档/README.md @@ -63,3 +63,4 @@ + diff --git a/docs/07-运维文档/02-环境变量配置模板.md b/docs/07-运维文档/02-环境变量配置模板.md index 6d499e4e..54575bd1 100644 --- a/docs/07-运维文档/02-环境变量配置模板.md +++ b/docs/07-运维文档/02-环境变量配置模板.md @@ -206,3 +206,4 @@ npm run dev + diff --git a/docs/09-架构实施/01-Schema隔离架构设计（10个）.md b/docs/09-架构实施/01-Schema隔离架构设计（10个）.md index 3892eb98..de7365d9 100644 --- a/docs/09-架构实施/01-Schema隔离架构设计（10个）.md +++ b/docs/09-架构实施/01-Schema隔离架构设计（10个）.md @@ -886,3 +886,4 @@ Week 1结束时，应达到： + diff --git a/docs/09-架构实施/04-平台基础设施规划.md b/docs/09-架构实施/04-平台基础设施规划.md index 2e451b70..18da4499 100644 --- a/docs/09-架构实施/04-平台基础设施规划.md +++ b/docs/09-架构实施/04-平台基础设施规划.md @@ -763,3 +763,4 @@ Day 3: 文档更新 4小时 **文档结束** + diff --git a/docs/09-架构实施/Prisma配置完成报告.md b/docs/09-架构实施/Prisma配置完成报告.md index b49a2b97..c556b9b1 100644 --- a/docs/09-架构实施/Prisma配置完成报告.md +++ b/docs/09-架构实施/Prisma配置完成报告.md @@ -202,3 +202,4 @@ model Project { + diff --git a/docs/09-架构实施/Schema迁移完成报告.md b/docs/09-架构实施/Schema迁移完成报告.md index fe0c1815..1d732e18 100644 --- a/docs/09-架构实施/Schema迁移完成报告.md +++ b/docs/09-架构实施/Schema迁移完成报告.md @@ -300,3 +300,4 @@ DROP SCHEMA IF EXISTS st_schema CASCADE; + diff --git a/docs/09-架构实施/migration-scripts/001-create-all-10-schemas.sql b/docs/09-架构实施/migration-scripts/001-create-all-10-schemas.sql index 6b192f82..0352aed4 100644 --- a/docs/09-架构实施/migration-scripts/001-create-all-10-schemas.sql +++ b/docs/09-架构实施/migration-scripts/001-create-all-10-schemas.sql @@ -126,3 +126,4 @@ ORDER BY nspname; + diff --git a/docs/09-架构实施/migration-scripts/002-migrate-platform.sql b/docs/09-架构实施/migration-scripts/002-migrate-platform.sql index 9c6387c9..b39d10ed 100644 --- a/docs/09-架构实施/migration-scripts/002-migrate-platform.sql +++ b/docs/09-架构实施/migration-scripts/002-migrate-platform.sql @@ -144,3 +144,4 @@ FROM platform_schema.users; + diff --git a/docs/09-架构实施/migration-scripts/003-migrate-aia.sql b/docs/09-架构实施/migration-scripts/003-migrate-aia.sql index bb5f29cb..1c5ce28b 100644 --- a/docs/09-架构实施/migration-scripts/003-migrate-aia.sql +++ b/docs/09-架构实施/migration-scripts/003-migrate-aia.sql @@ -337,3 +337,4 @@ FROM aia_schema.messages; + diff --git a/docs/09-架构实施/migration-scripts/004-migrate-pkb.sql b/docs/09-架构实施/migration-scripts/004-migrate-pkb.sql index 4c404ca7..4903df97 100644 --- a/docs/09-架构实施/migration-scripts/004-migrate-pkb.sql +++ b/docs/09-架构实施/migration-scripts/004-migrate-pkb.sql @@ -410,3 +410,4 @@ FROM pkb_schema.batch_tasks; + diff --git a/docs/09-架构实施/migration-scripts/005-validate-all.sql b/docs/09-架构实施/migration-scripts/005-validate-all.sql index 67199a8a..6d0ba975 100644 --- a/docs/09-架构实施/migration-scripts/005-validate-all.sql +++ b/docs/09-架构实施/migration-scripts/005-validate-all.sql @@ -542,3 +542,4 @@ SELECT + diff --git a/docs/09-架构实施/migration-scripts/execute-migration.ps1 b/docs/09-架构实施/migration-scripts/execute-migration.ps1 index de3fd8a5..2fe9a31f 100644 --- a/docs/09-架构实施/migration-scripts/execute-migration.ps1 +++ b/docs/09-架构实施/migration-scripts/execute-migration.ps1 @@ -266,3 +266,4 @@ Write-Host "脚本执行完成！" -ForegroundColor Green + diff --git a/docs/09-架构实施/前端模块注册机制实施报告.md b/docs/09-架构实施/前端模块注册机制实施报告.md index f3c083ed..f7e181c3 100644 --- a/docs/09-架构实施/前端模块注册机制实施报告.md +++ b/docs/09-架构实施/前端模块注册机制实施报告.md @@ -555,3 +555,4 @@ const MyComponent = () => { + diff --git a/docs/09-架构实施/后端代码分层-迁移计划.md b/docs/09-架构实施/后端代码分层-迁移计划.md index df2e95b4..f78804bc 100644 --- a/docs/09-架构实施/后端代码分层-迁移计划.md +++ b/docs/09-架构实施/后端代码分层-迁移计划.md @@ -458,3 +458,4 @@ import type { FastifyRequest, FastifyReply } from 'fastify' + diff --git a/docs/09-架构实施/后端代码分层实施报告.md b/docs/09-架构实施/后端代码分层实施报告.md index c790c825..c526982b 100644 --- a/docs/09-架构实施/后端代码分层实施报告.md +++ b/docs/09-架构实施/后端代码分层实施报告.md @@ -409,3 +409,4 @@ curl http://localhost:3001/api/v1/review + diff --git a/docs/09-架构实施/后端架构增量演进方案.md b/docs/09-架构实施/后端架构增量演进方案.md index 7ed3d949..ab473b4a 100644 --- a/docs/09-架构实施/后端架构增量演进方案.md +++ b/docs/09-架构实施/后端架构增量演进方案.md @@ -448,3 +448,4 @@ modules/ ← 新代码，标准化 + diff --git a/docs/09-架构实施/快速功能测试报告.md b/docs/09-架构实施/快速功能测试报告.md index d359914b..3d9772e6 100644 --- a/docs/09-架构实施/快速功能测试报告.md +++ b/docs/09-架构实施/快速功能测试报告.md @@ -242,3 +242,4 @@ Prisma Client在生成时已经读取了每个model的`@@schema()`标签， + diff --git a/docs/09-架构实施/数据库验证通过.md b/docs/09-架构实施/数据库验证通过.md index 4b4466bc..1be1fd69 100644 --- a/docs/09-架构实施/数据库验证通过.md +++ b/docs/09-架构实施/数据库验证通过.md @@ -85,3 +85,4 @@ + diff --git a/docs/09-架构实施/模块配置更新报告.md b/docs/09-架构实施/模块配置更新报告.md index 2bc1d1a7..4a9b588f 100644 --- a/docs/09-架构实施/模块配置更新报告.md +++ b/docs/09-架构实施/模块配置更新报告.md @@ -233,3 +233,4 @@ isExternal?: boolean + diff --git a/docs/09-架构实施/编码规范-UTF8最佳实践.md b/docs/09-架构实施/编码规范-UTF8最佳实践.md index 77dd7e8a..c14f3ed9 100644 --- a/docs/09-架构实施/编码规范-UTF8最佳实践.md +++ b/docs/09-架构实施/编码规范-UTF8最佳实践.md @@ -230,3 +230,4 @@ sed -i '1s/^\xEF\xBB\xBF//' file.txt + diff --git a/docs/[AI对接] 项目状态与下一步指南.md b/docs/[AI对接] 项目状态与下一步指南.md index b5f3a9da..9a2b631d 100644 --- a/docs/[AI对接] 项目状态与下一步指南.md +++ b/docs/[AI对接] 项目状态与下一步指南.md @@ -675,3 +675,4 @@ DELETE /api/v1/[module]/resources/:id # 删除 + diff --git a/docs/[完成] 文档重构总结报告.md b/docs/[完成] 文档重构总结报告.md index 61b541fc..66913a8a 100644 --- a/docs/[完成] 文档重构总结报告.md +++ b/docs/[完成] 文档重构总结报告.md @@ -364,3 +364,4 @@ L2模块（5分钟） → 深入了解具体模块 + diff --git a/docs/_templates/API设计-模板.md b/docs/_templates/API设计-模板.md index 37bd153c..38ff4d7a 100644 --- a/docs/_templates/API设计-模板.md +++ b/docs/_templates/API设计-模板.md @@ -473,3 +473,4 @@ curl -X POST "http://localhost:3001/api/v1/xxx/resources" \ + diff --git a/docs/_templates/README.md b/docs/_templates/README.md index 341f1f02..3d0dd537 100644 --- a/docs/_templates/README.md +++ b/docs/_templates/README.md @@ -77,3 +77,4 @@ + diff --git a/docs/_templates/[AI对接] 快速上下文-模板.md b/docs/_templates/[AI对接] 快速上下文-模板.md index ec1a264e..0e71ac43 100644 --- a/docs/_templates/[AI对接] 快速上下文-模板.md +++ b/docs/_templates/[AI对接] 快速上下文-模板.md @@ -178,3 +178,4 @@ POST /api/v1/[module]/[resource2] + diff --git a/docs/_templates/数据库设计-模板.md b/docs/_templates/数据库设计-模板.md index 9c960308..c5ff87cc 100644 --- a/docs/_templates/数据库设计-模板.md +++ b/docs/_templates/数据库设计-模板.md @@ -218,3 +218,4 @@ INSERT INTO xxx_schema.xxx_table_name (field_name, status) VALUES + diff --git a/docs/_templates/模块README-模板.md b/docs/_templates/模块README-模板.md index 7036011a..5e3c35ca 100644 --- a/docs/_templates/模块README-模板.md +++ b/docs/_templates/模块README-模板.md @@ -85,3 +85,4 @@ +