docs: Update architecture docs with platform infrastructure details

- Add platform infrastructure chapter to frontend-backend architecture design
- Update system architecture document with 6 new infrastructure modules
- Update AI onboarding guide with infrastructure overview
- Link to backend/src/common/README.md for detailed usage guide

Key Updates:
- Storage service (LocalAdapter + OSSAdapter)
- Logging system (Winston + JSON format)
- Cache service (Memory + Redis)
- Async job queue (Memory + Database)
- Health check endpoints
- Monitoring metrics
- Database connection pool
- Environment config management

All modules support zero-code switching between local and cloud environments.

Related: #Platform-Infrastructure
This commit is contained in:
2025-11-17 08:36:10 +08:00
parent 8bba33ac89
commit 31d555f7bb
88 changed files with 490 additions and 8 deletions

View File

@@ -17,10 +17,13 @@
## 📊 核心信息卡片
### 项目状态
- **当前阶段:** 架构设计完成,文档重构中
- **已完成:** AIA(AI问答)、PKB(知识库)、RVW(审稿)核心功能
- **下一步:** ASL(AI智能文献)模块开发
- **技术栈:** Node.js + React + PostgreSQL + Python微服务
- **当前阶段:** ✅ 平台基础设施完成准备ASL模块开发
- **已完成:**
- AIA(AI问答)、PKB(知识库)、RVW(审稿)核心功能
- ⭐ 平台基础设施2025-11-178个云原生模块
- 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)
---