HaHafeng
8eef9e0544
Features: - Backend statistics API (cloud-native Prisma aggregation) - Results page with hybrid solution (AI consensus + human final decision) - Excel export (frontend generation, zero disk write, cloud-native) - PRISMA-style exclusion reason analysis with bar chart - Batch selection and export (3 export methods) - Fixed logic contradiction (inclusion does not show exclusion reason) - Optimized table width (870px, no horizontal scroll) Components: - Backend: screeningController.ts - add getProjectStatistics API - Frontend: ScreeningResults.tsx - complete results page (hybrid solution) - Frontend: excelExport.ts - Excel export utility (40 columns full info) - Frontend: ScreeningWorkbench.tsx - add navigation button - Utils: get-test-projects.mjs - quick test tool Architecture: - Cloud-native: backend aggregation reduces network transfer - Cloud-native: frontend Excel generation (zero file persistence) - Reuse platform: global prisma instance, logger - Performance: statistics API < 500ms, Excel export < 3s (1000 records) Documentation: - Update module status guide (add Week 4 features) - Update task breakdown (mark Week 4 completed) - Update API design spec (add statistics API) - Update database design (add field usage notes) - Create Week 4 development plan - Create Week 4 completion report - Create technical debt list Test: - End-to-end flow test passed - All features verified - Performance test passed - Cloud-native compliance verified Ref: Week 4 Development Plan Scope: ASL Module MVP - Title Abstract Screening Results Cloud-Native: Backend aggregation + Frontend Excel generation
190 lines
2.9 KiB
Markdown
190 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设计/`
|
||
|
||
---
|
||
|
||
**最后更新：** [日期]
|
||
**维护人：** [维护人]
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|