PartShelf V2

现代化的电子元器件库存管理系统

智能批量导入 · 一键出库 · 参数筛选 · 可配置化 · MQTT 集成

查看源代码 快速开始
10+
核心功能模块
34
元器件分类
Docker
一键部署支持
MIT
开源许可证

✨ 功能特性

库存管理

  • 添加、编辑和删除电子元件
  • 实时库存数量跟踪
  • 器件详情弹窗（无需跳转）
  • 器件参数显示（带单位）

批量操作

  • CSV/Excel 批量导入
  • 一键批量出库
  • 智能零件匹配算法
  • 数据导出功能

历史记录

  • 完整的库存操作历史
  • 操作类型追踪
  • 数量变化记录
  • 操作备注支持

高级筛选

  • 多条件组合搜索
  • 参数筛选（文本/范围）
  • 编号通配符搜索
  • 筛选状态保持

可配置化

  • 自定义类别管理
  • 自定义子类别管理
  • 参数模板配置
  • 筛选类型设置

IoT 集成

  • MQTT 消息推送
  • 库存变更事件发布
  • 可配置的 MQTT 代理
  • 断线重连机制

🛠️ 技术栈

后端技术

Python 3.8+ FastAPI SQLAlchemy SQLite Pydantic

前端技术

HTML5 CSS3 JavaScript ES6+ Bootstrap 5 Font Awesome

工具和部署

Docker Docker Compose pandas openpyxl Uvicorn paho-mqtt

📸 界面预览

库存管理主界面
库存管理主界面

支持筛选、排序、批量操作

批量出库功能
批量出库功能

智能匹配，一键操作

库存历史记录
库存历史记录

完整的操作追踪

元件详情弹窗
元件详情弹窗

详细信息展示和管理

🚀 快速开始

Docker 部署（推荐）
# 克隆项目
git clone https://github.com/FASUZO/PartShelf-V2.git
cd PartShelf-V2

# 启动服务
docker-compose up -d

# 访问应用
# http://localhost:8000
本地开发
# 安装依赖
pip install -r requirements.txt

# 启动服务
uvicorn app.main:app --reload

# 访问应用
# http://localhost:8000
查看完整文档

🤝 参与贡献

欢迎贡献代码、报告问题或提出建议！

  1. Fork 本仓库
  2. 创建功能分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 提交 Pull Request
报告问题