Files
AIclinicalresearch/docs/_templates/[AI对接] 快速上下文-模板.md
HaHafeng e3e7e028e8 feat(platform): Complete platform infrastructure implementation and verification
Platform Infrastructure - 8 Core Modules Completed:
- Storage Service (LocalAdapter + OSSAdapter stub)
- Logging System (Winston + JSON format)
- Cache Service (MemoryCache + Redis stub)
- Async Job Queue (MemoryQueue + DatabaseQueue stub)
- Health Check Endpoints (liveness/readiness/detailed)
- Database Connection Pool (with Serverless optimization)
- Environment Configuration Management
- Monitoring Metrics (DB connections/memory/API)

Key Features:
- Adapter Pattern for zero-code environment switching
- Full backward compatibility with legacy modules
- 100% test coverage (all 8 modules verified)
- Complete documentation (11 docs updated)

Technical Improvements:
- Fixed duplicate /health route registration issue
- Fixed TypeScript interface export (export type)
- Installed winston dependency
- Added structured logging with context support
- Implemented graceful shutdown for Serverless
- Added connection pool optimization for SAE

Documentation Updates:
- Platform infrastructure planning (04-骞冲彴鍩虹璁炬柦瑙勫垝.md)
- Implementation report (2025-11-17-骞冲彴鍩虹璁炬柦瀹炴柦瀹屾垚鎶ュ憡.md)
- Verification report (2025-11-17-骞冲彴鍩虹璁炬柦楠岃瘉鎶ュ憡.md)
- Git commit guidelines (06-Git鎻愪氦瑙勮寖.md) - Added commit frequency rules
- Updated 3 core architecture documents

Code Statistics:
- New code: 2,532 lines
- New files: 22
- Updated files: 130+
- Test pass rate: 100% (8/8 modules)

Deployment Readiness:
- Local environment: 鉁?Ready
- Cloud environment: 馃攧 Needs OSS/Redis dependencies

Next Steps:
- Ready to start ASL module development
- Can directly use storage/logger/cache/jobQueue

Tested: Local verification 100% passed
Related: #Platform-Infrastructure
2025-11-18 08:00:41 +08:00

183 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# [AI对接] [模块名]快速上下文
> **阅读时间:** [2-5]分钟
> **Token消耗** ~[800-2000] tokens
> **前置阅读:** `00-系统总体设计/[AI对接] 快速上下文.md`如果是L2级别
---
## 📋 模块定位
[一句话描述模块核心功能和价值]
**商业价值:** ⭐⭐⭐⭐⭐ [评级]
**开发状态:** [✅已完成 / ⏳开发中 / ⏳规划中]
**依赖能力:** [列出依赖的通用能力]
---
## 🎯 核心功能
[列出3-6个核心功能用1-2句话描述每个功能]
1.**功能1** - 简要描述
2.**功能2** - 简要描述
3.**功能3** - 简要描述
**本周重点:** [当前开发重点]
---
## 🏗️ 技术架构一览
### 前端React
```
src/pages/[ModuleName]/
├── [SubModule1]/
├── [SubModule2]/
└── ...
```
### 后端Node.js
```
backend/src/modules/[module_code]/
├── controllers/
├── services/
└── routes/
```
### 数据库([module]_schema
```sql
CREATE SCHEMA [module]_schema;
- [table1] # 1
- [table2] # 2
- ...
```
---
## 💡 核心业务流程
[用简洁的流程图或步骤描述最核心的业务流程]
```
1. 用户操作
2. 前端处理
3. 后端处理
4. 数据存储
5. 返回结果
```
---
## 📚 已有设计文档
### PRD文档
- `00-项目概述/01-产品需求文档(PRD).md` - [简要说明]
### 技术设计
- `01-设计文档/02-数据库设计.md` - [简要说明]
- `01-设计文档/03-API设计.md` - [简要说明]
### UI原型
- `01-设计文档/07-UI设计/[原型文件].html`
---
## 🔗 依赖的通用能力
### [能力1][状态]
```typescript
// 接口示例或关键说明
```
### [能力2][状态]
```typescript
// 接口示例或关键说明
```
---
## 📋 API端点清单
### [功能模块1]
```
POST /api/v1/[module]/[resource]
GET /api/v1/[module]/[resource]
...
```
### [功能模块2]
```
POST /api/v1/[module]/[resource2]
...
```
---
## 📅 开发计划
### Week 1
- Day 1-2[任务]
- Day 3-4[任务]
- Day 5[任务]
### Week 2
- Day 1-2[任务]
...
---
## ⚠️ 关键技术难点
1. **难点1** - [说明和解决方案]
2. **难点2** - [说明和解决方案]
---
## ✅ 快速开发检查清单
**开始开发前确认:**
- [ ] [依赖能力1]是否已实现?
- [ ] 数据库Schema是否已创建
- [ ] Prisma Schema是否已更新
- [ ] API路由是否已注册
**常见问题:**
- Q: [问题]
- A: [答案]
---
## 📖 更多详细信息
**需要完整PRD**`00-项目概述/01-产品需求文档(PRD).md`
**需要数据库详情:**`01-设计文档/02-数据库设计.md`
**需要API详情**`01-设计文档/03-API设计.md`
**需要UI设计**`01-设计文档/07-UI设计/`
---
**最后更新:** [日期]
**维护人:** [维护人]