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
183 lines
2.9 KiB
Markdown
183 lines
2.9 KiB
Markdown
# [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设计/`
|
||
|
||
---
|
||
|
||
**最后更新:** [日期]
|
||
**维护人:** [维护人]
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|