# partbox-miniprogram

**Repository Path**: hoowaynew/partbox-miniprogram

## Basic Information

- **Project Name**: partbox-miniprogram
- **Description**: 元件管家 - 微信小程序 | 电子元器件库存管理 DIY零件库存
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-20
- **Last Updated**: 2026-05-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 元件管家 v1.0.0

> ⚡ 专为 DIY 电子爱好者打造的元器件库存管理微信小程序

[![version](https://img.shields.io/badge/version-v1.0.0-blue)](.) [![platform](https://img.shields.io/badge/platform-微信小程序-green)](.) [![cloud](https://img.shields.io/badge/后端-云开发-orange)](.)

## 功能特性

- 📦 **元件库存管理** — 分类浏览、搜索、出入库操作、库存预警
- 🛒 **立创商城订单导入** — 自动识别商品编号/封装/价格，智能追加/新建
- 📄 **BOM备料管理** — 导入立创EDA BOM，三级匹配算法，快速识别缺货
- 📋 **出入库流水** — 完整操作记录，7种来源类型，支持筛选/导出
- 📍 **位置管理** — 三级树形结构（柜→抽屉→格），精确定位
- 🏷 **标签打印** — 生成元件标签二维码
- 🌙 **深色模式** — 跟随系统自动切换

## 技术栈

- 微信小程序原生框架
- 云开发（云函数 + 云数据库 + 云存储）
- AppID: `wx19c73915a4a40943`

## 目录结构

```
partbox-miniprogram/
├── miniprogram/               # 小程序主体
│   ├── app.js/json/wxss       # 全局配置与样式
│   ├── config/cloud.js        # 云环境配置
│   ├── utils/                 # 工具模块
│   │   ├── db.js              # 数据库封装
│   │   ├── store.js           # 全局状态
│   │   ├── toast.js           # Toast/Loading
│   │   └── category-templates.js  # 分类色系配置
│   ├── services/partService.js    # 元件业务逻辑
│   ├── components/            # 可复用组件
│   │   ├── part-card/         # 元件卡片
│   │   └── stock-action-sheet/ # 出入库弹窗
│   └── pages/                 # 页面
│       ├── index/             # 首页（仪表盘）
│       ├── inventory/         # 库存列表
│       ├── part-detail/       # 元件详情
│       ├── part-edit/         # 元件录入/编辑
│       ├── projects/          # 项目BOM列表
│       ├── mine/              # 我的
│       ├── location/          # 位置管理
│       ├── stock-log/         # 出入库流水
│       ├── import-export/     # 导入导出中心
│       └── import-lcsc-preview/ # 立创订单导入预览
├── cloudfunctions/            # 云函数
│   ├── login/                 # 登录/注册
│   ├── getStats/              # 统计数据
│   ├── searchParts/           # 全文搜索
│   ├── parseLcscOrder/        # 解析立创订单文件
│   ├── importLcscOrder/       # 执行批量导入
│   └── exportData/            # 导出库存/流水
└── README.md
```

## 数据库集合

| 集合 | 说明 |
|------|------|
| `parts` | 元件主数据（型号/参数/库存/位置） |
| `categories` | 分类（可扩展） |
| `locations` | 位置树（三级：柜→抽屉→格） |
| `stock_logs` | 出入库流水记录 |
| `projects` | 项目BOM |
| `bom_items` | BOM行项目 |
| `import_tasks` | 导入历史记录 |
| `purchase_logs` | 采购记录 |
| `users` | 用户表 |

## 首次使用

1. 在微信开发者工具打开本项目
2. 修改 `miniprogram/config/cloud.js` 中的 `cloudEnvId`
3. 部署各云函数
4. 编译运行，通过「导入导出 → 立创商城订单」导入第一批元件

## 版本历史

### v1.0.0 (2026-05-20)
- 🎉 初始版本发布
- 首页仪表盘（库存统计、低库存预警、快捷入口）
- 库存列表（搜索、分类筛选、出入库操作）
- 元件详情（参数展示、±出入库、采购历史）
- 元件录入/编辑（分类专属字段）
- 项目BOM（列表、新建）
- 我的（功能导航、概览数字）
- 位置管理（三级树形）
- 出入库流水记录（分组展示、汇总条）
- 导入导出中心（立创订单、BOM、手动录入）
- 立创商城订单导入预览（六态状态机）
- 云函数：login/getStats/searchParts/parseLcscOrder/importLcscOrder/exportData