feat:增强箱子管理功能与界面优化

- 新增箱子重命名与删除功能
- 引入新箱子前缀与起始编号配置
- 在首页展示箱子编号范围
- 添加概览按钮,快速查看已启用的物品及其名称
- 实现组件的启用/禁用功能
- 更新数据库结构,新增箱子与组件字段
- 优化箱子与组件管理界面,改进表单与表格展示
- 在索引页面增加箱子详细信息概览区域
- 增强扫描与搜索功能,优化结果显示效果
This commit is contained in:
2026-03-08 02:48:24 +08:00
parent 672336c578
commit 22147a1c03
7 changed files with 656 additions and 334 deletions

View File

@@ -8,6 +8,14 @@
- `14格中盒大盒`:中等盒子,无固定摆放图。
- `袋装清单`:防静电袋列表模式(每行一个袋位,支持批量新增)。
v1.1 新增能力:
- 支持盒子改名和删除。
- 新增盒子时可设置 `前缀 + 起始序号`,内部编号自动递增。
- 首页可直接看到每个盒子的编号范围(如 `A1-A28`)。
- 首页新增概览按钮:快速查看已启用的编号与名称。
- 编辑页支持 `启用/停用`
## 1. 项目结构
```text
@@ -59,15 +67,19 @@ python app.py
- 按容器类型显示 3 个列表。
- 每个列表都可新增盒子。
- 每个盒子可在首页直接改名、修改前缀和起始序号、删除。
- 每个盒子有概览按钮,快速查看已启用条目。
### 3.2 盒子详情 `/box/<box_id>`
- `28格/14格`:格子视图,点格子进入编辑。
- `袋装清单`:表格视图,支持单条新增和批量新增。
- 页面显示自动编号范围(由前缀+起始序号生成)。
### 3.3 编辑页 `/edit/<box_id>/<slot>`
- 编辑料号、名称、规格、数量、位置备注、备注。
- 支持勾选启用,或通过按钮启用/停用。
- 可删除当前格子记录。
### 3.4 扫码/搜索 `/scan`
@@ -96,13 +108,50 @@ python app.py
- `数量` 需为大于等于 0 的整数(留空按 0
- 无效行会跳过并提示。
## 5. 数据库说明
## 5. 自动编号规则(新增)
新增盒子时只需填写:
- `前缀`:如 `A``B``C``BAG`
- `起始序号`:如 `1`
系统自动生成内部编号:
- 第 1 位:`前缀 + 起始序号`
- 第 N 位:`前缀 + (起始序号 + N - 1)`
示例:
- 前缀 `A`、起始 `1`、容量 28 -> `A1-A28`
- 前缀 `B`、起始 `100`、容量 14 -> `B100-B113`
## 6. 元器件命名建议(简洁版)
为避免命名过长又保证可检索,建议:
- `料号(part_no)`:优先写厂家/采购料号,保持唯一。
- `名称(name)``品类 + 关键值 + 封装`,如 `电阻10K 0603``电容100nF 0603`
- `规格(specification)`:补充精度/耐压/温漂等必要信息,如 `1%``50V X7R`
推荐格式:
```text
名称: 电阻10K 0603
规格: 1%
```
```text
名称: 电容100nF 0603
规格: 50V X7R
```
## 7. 数据库说明
- 使用 SQLite文件路径`data/inventory.db`
- 首次发布执行一次 `python init_db.py`
- 后续通常不需要重复初始化
## 6. 服务器部署(宝塔)
## 8. 服务器部署(宝塔)
建议流程:
@@ -116,7 +165,7 @@ python app.py
建议 Gunicorn 仅监听内网:`127.0.0.1:5000`
## 7. 日常发布流程
## 9. 日常发布流程
本地开发后:
@@ -137,7 +186,7 @@ pip install -r requirements.txt
最后在宝塔里重启 Python 项目。
## 8. 备份建议
## 10. 备份建议
重点备份:`data/inventory.db`
@@ -147,7 +196,7 @@ pip install -r requirements.txt
cp /www/wwwroot/inventory/data/inventory.db /www/backup/inventory_$(date +%F).db
```
## 9. 常见问题
## 11. 常见问题
### Q1: VS Code 提示无法解析 `flask` 导入