# ETest-LIMS 项目概览

## 一句话描述
测试中心工单管理系统，支持样品入库、测试工单派发、报告生成与多级审核。

## 技术栈
- **后端**: FastAPI + SQLAlchemy + MySQL
- **前端**: Vue3 + Element Plus
- **基础框架**: 若依 (RuoYi) FastAPI 版本

## 目录结构
```
ETest-Vue-FastAPI/
├── ruoyi-fastapi-backend/     # 后端代码
│   ├── module_admin/           # 管理模块
│   │   ├── controller/         # 控制器
│   │   ├── service/            # 服务层
│   │   ├── dao/                # 数据访问层
│   │   └── entity/
│   │       ├── do/             # 实体定义
│   │       └── vo/             # 视图对象
│   └── module_task/            # 任务模块
├── ruoyi-fastapi-frontend/     # 前端代码
├── sql/                        # 数据库脚本
├── docs/                       # 项目文档
└── references/                 # 参考资料
```

## 核心模块

| 模块 | 职责 | 入口文件 |
|------|------|----------|
| 入库管理 | 入库单创建、样品管理 | `warehouse_receipt_controller.py` |
| 工单管理 | 工单生成、领取、执行 | `test_work_order` 相关 |
| 测试管理 | 测试类别、测试流程 | `test_category`, `test_flow` |
| 报告管理 | 报告生成、多级审核 | `test_report` 相关 |

## 关键配置
- 数据库连接: `config/database.py`
- 路由注册: `module_admin/controller/`
- 实体定义: `module_admin/entity/do/`

## 最近变更
- 2026-03-21: 创建项目文档结构
- 2026-03-21: 设计 10 个新需求的架构方案

## 待办事项
- [ ] 测试类别父子层级改造
- [ ] 工单自动领取功能
- [ ] 报告多级审核流程
- [ ] 数据库迁移脚本

## 参考文档
- [架构设计](ARCHITECTURE.md)
- [数据模型](DATA_MODEL.md)
- [业务逻辑](BUSINESS_LOGIC.md)
- [Agent 交接记录](AGENT_HANDOVER.md)