# 药品管理系统

**Repository Path**: lye21/drug-management-system

## Basic Information

- **Project Name**: 药品管理系统
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-30
- **Last Updated**: 2026-05-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 药品仓储管理系统

## 项目概况
药品仓储管理系统，前后端分离架构，支持多组织、多仓库的药品入库、出库、库存管理和报表统计功能。

- **在线访问**: https://www.lye21.top/drug/
- **后端**: Django REST Framework，位于 `backend/`
- **前端**: Vue 3 + Element Plus + Vite，位于 `frontend/`

## 技术栈

### 前端
- Vue 3 Composition API (`<script setup>`)
- Element Plus UI 框架
- Pinia 状态管理
- Axios HTTP 客户端
- ECharts / vue-echarts 图表
- SCSS 样式，使用自定义 mixin/变量（`$bio-*` 系列）
- Vite 开发服务器（默认端口 5173）
- Playwright E2E 测试

### 后端
- Django REST Framework
- PostgreSQL 数据库
- JWT 认证（SimpleJWT）

## 开发命令

```bash
# 前端开发
cd frontend && npm run dev

# 前端构建
cd frontend && npm run build

# E2E 测试
cd frontend && npx playwright test --reporter=list --workers=2

# 后端启动
cd backend && python manage.py runserver
```

## 部署说明

### 服务器信息
- **服务器 IP**: 101.96.194.12
- **域名**: www.lye21.top
- **部署路径**: /drug/ 子路径

### 前端部署
```bash
# 本地构建
cd frontend && npm run build

# 部署到服务器
rsync -avz --delete frontend/dist/ root@101.96.194.12:/opt/drug-mgmt/frontend/dist/
```

### 后端部署
后端服务运行在 8000 端口，通过 Nginx 反向代理。

## 功能模块

### 用户权限
- **管理员**: 所有功能权限
- **仓库管理员**: 基础数据管理、入库管理、出库管理、盘点管理、库存查询、报表统计
- **普通员工**: 库存查询、报表查看（只读权限）

### 业务管理
1. **入库管理**: 入库单创建、编辑、删除、审核，支持状态筛选（待审核/已完成）
2. **出库管理**: 出库单创建、编辑、删除、审核，支持状态筛选（待审核/已完成）
3. **盘点管理**: 盘点单创建、盘点差异处理
4. **库存查询**: 库存列表、按仓库/分类筛选、库存预警

### 基础数据
- 药品管理（名称、编码、规格、单位、分类）
- 供应商管理
- 客户管理
- 仓库管理
- 药品设置（分类、单位管理）

### 报表统计
- 库存报表：库存汇总、按仓库/分类统计、库存预警
- 入库报表：入库汇总、按供应商统计、入库趋势
- 出库报表：出库汇总、按客户统计、出库趋势

## 移动端适配

系统支持移动端访问，自动识别设备类型并渲染对应的移动版组件：
- 底部 TabBar 导航：首页、入库、出库、盘点、更多
- 卡片列表替代表格
- 全屏表单页面
- 筛选弹窗

## 关键约定

- `<el-button>` 在 `<el-dialog>` 的 `<el-form>` 内必须加 `native-type="button"`，否则默认 `native-type="submit"` 会触发表单提交导致页面刷新
- 原生 `<button>` 元素必须加 `type="button"`，防止默认 submit 行为
- E2E 测试使用 Playwright，配置在 `frontend/playwright.config.js`
- 测试数据使用 `uid()` 函数生成唯一编码，避免重复冲突

## 测试注意

- Playwright 测试 timeout 默认 60s，并发 2 workers 时部分测试可能因资源竞争超时
- `waitForLoadState('networkidle')` 在并发场景下可能不稳定，建议用 `waitForTimeout` 或元素等待替代
- 截图文件（.png）大模型无法直接读取，需通过 error-context.md 或日志分析失败原因