PartShelf V2

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

智能批量导入 · 一键出库 · 库存历史追踪 · 模块化架构

8+
核心功能模块
100%
中文注释覆盖
Docker
一键部署支持
MIT
开源许可证

✨ 功能特性

库存管理

  • 添加、编辑和删除电子元件
  • 实时库存数量跟踪
  • 按类型、封装、制造商分类
  • 单件入库/出库操作

批量操作

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

历史记录

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

高级筛选

  • 多条件组合搜索
  • 可筛选字段搜索
  • 表头排序功能
  • 分页显示

用户界面

  • 响应式设计
  • 现代化 UI
  • 流畅动画效果
  • 实时操作反馈

模块化架构

  • 前端 8 个功能模块
  • 清晰的代码结构
  • 易于维护和扩展
  • 完整的中文注释

🛠️ 技术栈

后端技术

Python 3.8+ FastAPI SQLAlchemy SQLite Pydantic

前端技术

HTML5 CSS3 JavaScript ES6+ Bootstrap 5 Font Awesome

工具和部署

Docker Docker Compose pandas openpyxl Uvicorn

📸 界面预览

库存管理主界面

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

批量出库功能

智能匹配,一键操作

库存历史记录

完整的操作追踪

元件详情页面

详细信息展示和管理

提示: 您可以在项目运行后添加实际截图到 screenshots/ 目录

🚀 快速开始

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
报告问题