# 简单的库存管理系统

**Repository Path**: jun-sun/simple-laboratory-storage-system

## Basic Information

- **Project Name**: 简单的库存管理系统
- **Description**: 一个简单的，单机单用户的管理库存的系统，基于实验室使用场景开发，基于html开源，点击可用
- **Primary Language**: HTML
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-13
- **Last Updated**: 2025-10-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 实验室耗材管理系统

一个基于 Web 的轻量级实验室耗材库存管理系统，无需后端服务器，数据完全存储在浏览器本地，支持导出备份、操作日志、过期提醒等功能。

---

## 🧪 项目简介

这是一个**纯前端**的实验室耗材管理系统，采用 HTML + Tailwind CSS + JavaScript 实现，无需安装任何依赖或后端服务，直接在浏览器中打开即可使用。系统支持：

- ✅ 添加、编辑、删除耗材信息  
- ✅ 领用/补充库存并记录操作日志  
- ✅ 自动提醒低库存与即将过期物品  
- ✅ 支持按名称、位置、库存、效期等多维度筛选与排序  
- ✅ 一键导出库存快照（CSV）与操作日志  
- ✅ 从 CSV 文件恢复库存数据  
- ✅ 自动生成购物清单（低库存物品）  
- ✅ 所有数据自动保存在浏览器本地存储（LocalStorage）

---

## 🚀 快速开始
直接打开部署的网站
[库存管理系统](https://bm0z7hor.html2web.com)
### 方法一：在本地直接打开

1. 下载本项目代码：
   ```bash
   git clone https://gitee.com/jun-sun/simple-laboratory-storage-system.git
   ```
2. 进入项目目录，双击打开 `实验室库存系统.html` 文件即可使用。

### 方法二：本地部署（可选）

如果你有本地 Web 服务器（如 Python、Node.js、Nginx 等），可以将项目目录放入 Web 根目录，通过 `http://localhost/实验室库存系统.html` 访问。

---

## 📦 功能详解

| 功能模块 | 说明 |
|----------|------|
| **库存管理** | 添加、编辑、删除耗材；支持名称、货号、单位、位置、过期日期、低库存阈值等字段。 |
| **库存操作** | 支持“领用”与“补充”两种操作，自动更新库存并记录日志。 |
| **过期提醒** | 自动标红已过期或即将过期（≤30天）的物品。 |
| **低库存提醒** | 库存低于设定阈值时，自动标黄并支持生成购物清单。 |
| **操作日志** | 每次领用/补充操作都会记录时间、物品、数量、操作人，支持导出为 CSV。 |
| **数据备份与恢复** | 支持导出库存快照为 CSV 文件，也支持从 CSV 文件恢复库存（会清空当前数据）。 |
| **搜索与筛选** | 支持按名称搜索、按位置筛选、按库存或效期排序。 |
| **本地存储** | 所有数据自动保存在浏览器本地存储，无需服务器，刷新页面不丢失。 |

---

## 📁 项目结构

```
lab-inventory-system/
├── 实验室库存系统.html   # 主程序文件（单文件应用）
└── README.md             # 项目说明文档（本文档）
```

---

## 🧪 使用示例

### 添加新耗材
1. 点击“＋ 添加新耗材”按钮；
2. 填写名称、单位、位置、货号、过期日期、低库存阈值；
3. 输入初始数量和操作人；
4. 点击“确认”完成添加。

### 领用耗材
1. 在库存列表中找到目标物品；
2. 点击“领用”按钮；
3. 输入领用数量和操作人；
4. 点击“确认”完成领用，库存自动减少，操作日志自动记录。

### 导出购物清单
1. 点击“生成购物清单”按钮；
2. 系统会自动列出所有库存低于阈值的物品；
3. 点击“复制清单”可将列表复制到剪贴板，方便粘贴到 Excel 或发送给采购。

---

## 📊 数据格式说明

### 库存快照 CSV 格式（导出/导入）
| 品名 | 货号 | 位置 | 单位 | 当前库存 | 库存阈值 | 过期日期 |
|------|------|------|------|----------|----------|----------|
| PBS缓冲液 | P5493 | 4°C冰箱 | 瓶 | 3 | 5 | 2025-12-31 |

### 操作日志 CSV 格式（导出）
| 时间戳 | 品名 | 操作类型 | 数量变化 | 操作后库存 | 操作人 | 单位 |
|--------|------|----------|----------|------------|--------|------|
| 2025-10-13T08:30:00.000Z | PBS缓冲液 | 入库 | +10 | 13 | 张三 | 瓶 |

---

## ⚠️ 注意事项

- **数据仅保存在本地浏览器缓存中**，清除浏览器缓存会导致数据丢失，请定期导出备份；
- 建议在每次重要操作后手动导出库存快照作为备份；
- 导入 CSV 会**覆盖当前所有数据**，请谨慎操作；
- 本项目为单页应用，**无需联网**，也**无需后端服务器**；
- 支持现代浏览器（Chrome、Edge、Firefox、Safari 等），IE 不支持。

---

## 🛠️ 技术栈

- **HTML5 + Tailwind CSS**：界面布局与样式
- **原生 JavaScript**：逻辑处理与数据管理
- **LocalStorage**：本地数据持久化
- **CSV 格式**：数据导入/导出标准

---

## 📌 后续计划（Roadmap）

- [ ] 支持多用户权限管理（需后端）
- [ ] 支持二维码/条形码扫描（需摄像头权限）
- [ ] 支持多语言（中英文切换）
- [ ] 支持暗黑模式
- [ ] 支持 PWA 离线安装

---

## 🤝 贡献指南

欢迎提交 Issue 或 Pull Request！

- 发现 Bug 或有新功能建议，请在 Issues中提出；
- 欢迎 Fork 本项目并提交 PR，我们会尽快审核。

---

## 📄 开源协议

本项目采用 [MIT License](https://opensource.org/licenses/MIT) 开源协议，您可以自由使用、修改和分发。

---

## 📬 联系方式

如有问题或建议，欢迎联系：

- Email: junsun@qq.com

---

**⭐ 如果本项目对您有帮助，欢迎点个 Star 支持一下！**