1. 项目背景与核心价值
办公设备与耗材管理一直是企事业单位行政工作中的痛点。传统纸质登记方式效率低下、易出错，而市面上的大型资产管理系统又往往功能冗余、操作复杂。这个基于SpringBoot的纸笔管理系统小程序正是针对这一细分场景的轻量化解决方案。
我在某中型企业IT部门任职期间，曾亲眼目睹行政人员每天要花费2-3小时手工登记打印纸、签字笔等耗材的领用情况。这种低效管理导致两个典型问题：一是月底盘点时经常出现账实不符，二是无法实时掌握库存导致突发性缺货。这个项目用技术手段完美解决了这些痛点。
2. 技术选型解析
2.1 SpringBoot框架优势
选择SpringBoot作为后端框架主要基于三点考量：
- 快速开发特性：通过starter依赖和自动配置，能在几天内搭建出完整的管理系统原型
- 微服务友好：未来可轻松扩展为多模块的资产管理系统
- 生态丰富：整合MyBatis-Plus、Redis等中间件非常便捷
典型依赖配置示例：
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.3</version> </dependency>2.2 微信小程序端考量
选用小程序而非原生APP主要因为：
- 零安装成本：用户扫码即用
- 跨平台特性：同时支持iOS和Android
- 微信生态优势：可直接使用微信通讯录选择领用人
特别注意：小程序端需处理canvas绘制库存图表时的适配问题，这是常见痛点。解决方案是通过wx.getSystemInfo获取设备宽度后动态设置canvas尺寸。
3. 核心功能实现
3.1 库存管理模块
采用"基础库存+动态流水"的双表设计：
- 基础库存表：记录物品ID、名称、规格、总数量等静态信息
- 流水表：记录每次领用/归还的操作明细
关键SQL示例：
-- 领用操作事务 BEGIN; UPDATE item SET stock = stock - #{count} WHERE id = #{itemId}; INSERT INTO ledger(item_id, operator, count, type) VALUES(#{itemId}, #{operator}, #{count}, 'OUT'); COMMIT;3.2 智能预警机制
实现三级库存预警：
- 黄色预警：库存低于安全库存20%时
- 橙色预警：库存低于安全库存10%时
- 红色预警：库存为0时
通过Spring Scheduler定时扫描库存状态，结合微信模板消息推送预警：
@Scheduled(cron = "0 0 9 * * ?") public void checkStock() { List<Item> lowStockItems = itemMapper.selectLowStockItems(); lowStockItems.forEach(item -> { String message = String.format("%s库存仅剩%d件", item.getName(), item.getStock()); wechatService.sendTemplateMsg(item.getManager(), message); }); }4. 开发避坑指南
4.1 并发控制方案
实测中发现当多人同时领用同一物品时会出现超发问题。最终采用三种防护措施：
- 数据库乐观锁：version字段控制
- Redis分布式锁：针对高频领用物品
- 前端防重提交：按钮点击后禁用3秒
4.2 小程序性能优化
初期加载缓慢问题通过以下手段解决：
- 接口数据分页加载（每页20条）
- 静态资源走CDN
- 使用小程序分包技术
- 关键数据本地缓存
5. 扩展建议
5.1 功能扩展方向
- 对接采购系统：库存预警后自动生成采购单
- 增加RFID识别：实现实物快速盘点
- 数据分析看板：用量趋势预测
5.2 部署方案选型
推荐两种生产环境部署方式：
传统部署：
- 2核4G云服务器
- Nginx反向代理
- MySQL主从配置
容器化部署（适合已有K8s环境）：
FROM openjdk:11-jre COPY target/office-manager.jar /app.jar ENTRYPOINT ["java","-jar","/app.jar"]6. 项目交付说明
源码包包含三个核心模块：
- backend：SpringBoot后端工程
- miniprogram：微信小程序前端
- docs：包含数据库脚本、API文档和部署指南
调试建议：
- 先导入SQL脚本初始化数据库
- 修改application-dev.yml中的数据库配置
- 小程序端修改project.config.json中的appid
重要提示：首次启动时会自动初始化测试数据，生产环境务必关闭spring.datasource.initialization-mode=never
这个项目我在实际部署时发现一个易忽略的问题：微信小程序要求后端域名必须备案且开启HTTPS。建议使用Let's Encrypt免费证书，配合Nginx配置SSL卸载，具体配置可参考源码中的nginx.conf示例。
