StockDesk

轻量级桌面库存管理软件 · 源自真实仓储工作经历

2026/09/25桌面应用 AI 辅助开发

01.解决的问题

中小仓库管理的典型痛点：历史库存散落在 Excel 里迁移困难；同一物资多批次无法追溯单价与来源；出库不按先进先出（FIFO）执行；低库存无自动预警；财务对账缺乏金额统计。StockDesk 把这些做进一个免安装的桌面软件。

02.核心功能

批次库存：同一物资多批次独立管理（单价 / 来源 / 存放位置），总库存与剩余库存金额自动汇总
FIFO 先进先出出库：按入库日期最早的批次优先扣减，禁止负库存；每笔出库生成批次扣减明细，完全可追溯
归还管理：关联出库单归还时按原批次明细回填库存（单价可追溯），超额 / 重复归还自动拦截
Excel 双向同步：四步向导批量导入期初库存（列映射 + 单位换算 + 进度条）；全量导出为单文件多工作表（档案 / 入库 / 出库 / 归还 / 部门等 8 类）
数据安全：原子写入（.tmp → os.replace）防断电损坏；自动备份保留最近 5 份，支持从备份恢复
九大页面：库存总览 / 入库 / 出库 / 归还 / 流水台账 / 物资档案 / 部门管理 / 导入导出 / 系统设置

03.技术栈

语言：Python 3.10+
UI：CustomTkinter（现代 Tkinter 封装，亮 / 暗主题一键切换）
Excel 读写：openpyxl（不依赖 Office）
存储：JSON 单文件（人类可读，线程安全读写）
打包：PyInstaller 绿色免安装 exe，Windows / macOS / Linux 通用

04.架构设计

四层分层架构：UI 层（10 个页面 + 4 个通用组件）→ 业务层（8 个 Service 类，依赖注入）→ 数据层（JsonStorage 原子写入）→ 数据文件（data.json + backups/）。以出库为例的数据流：校验库存 → 按入库日期升序 FIFO 循环扣减 → 生成出库记录 + 批次明细 → 原子写入。