一、项目背景与需求分析
在电子配件行业，键盘作为高频次入库商品，传统手工登记方式导致库存数据不准确、入库效率低下、操作人员重复劳动等问题日益突出。某电子科技公司曾因库存信息滞后，导致2023年Q2出现5次缺货订单，直接损失约12万元。本项目基于实际业务痛点，设计一套标准化键盘入库管理系统，核心需求包括：支持多仓库管理、实时库存查询、批量入库处理、操作日志追踪、数据报表生成，以及与企业ERP系统的API对接。需求分析阶段通过与仓库管理员深度访谈，梳理出12项核心业务流程，例如键盘型号（如机械轴/薄膜轴）、批次号、供应商编码、入库时间、质检状态等关键字段必须纳入系统管理。
二、技术选型与架构设计
系统采用Spring Boot 3.1.0作为基础框架，结合MyBatis Plus 3.5.5实现数据访问层，数据库选用MySQL 8.0.34，并通过Redis 7.2.1构建缓存层。架构设计遵循分层原则：表现层使用Thymeleaf模板引擎，业务逻辑层采用领域驱动设计（DDD），数据访问层通过MyBatis动态SQL优化查询效率。技术选型依据包括：Spring Boot的自动配置能力可减少70%样板代码；MyBatis Plus的CRUD增强功能提升开发效率；Redis缓存热点数据（如常用键盘型号列表）将库存查询响应时间从800ms降至150ms。系统部署采用Docker容器化，通过Nginx反向代理实现高可用架构，单节点可支撑500并发请求。
三、数据库设计与优化策略
数据库设计采用三范式规范，核心表结构包含：
- tb_keyboard_info（键盘信息表）：id(INT,PK), model(VARCHAR), type(ENUM('机械轴','薄膜轴')), spec(VARCHAR), unit_price(DECIMAL), stock_quantity(INT)
- tb_inbound_record（入库记录表）：id(INT,PK), keyboard_id(INT,FK), batch_no(VARCHAR), quantity(INT), operator(VARCHAR), create_time(TIMESTAMP)
- tb_warehouse（仓库信息表）：id(INT,PK), name(VARCHAR), location(VARCHAR), max_capacity(INT)
针对高频查询场景，为tb_keyboard_info的model字段建立复合索引，使型号搜索效率提升3倍；对tb_inbound_record的create_time字段建立时间范围索引，优化月度报表生成速度。通过分表策略，将tb_inbound_record按年份拆分为tb_inbound_record_2023、tb_inbound_record_2024等，避免单表数据量超过500万导致的性能下降。在MySQL配置中启用查询缓存（query_cache_type=ON），针对重复的库存查询请求，缓存命中率达65%。
四、核心功能模块实现
4.1 批量入库功能：实现Excel导入接口，支持批量处理5000条/次的入库数据。关键代码逻辑：
public void importInboundData(MultipartFile file) {
List dataList = ExcelUtil.parseExcel(file);
for (InboundDTO dto : dataList) {
if (keyboardService.exists(dto.getModel())) {
keyboardService.updateStock(dto.getModel(), dto.getQuantity());
} else {
keyboardService.create(dto);
}
inboundService.save(dto);
}
}
该功能通过事务管理确保数据一致性，使用多线程处理Excel解析（Apache POI），将1000条数据导入时间从45秒缩短至8秒。
4.2 实时库存预警：基于Redis的ZSET数据结构存储库存阈值，当库存量低于预设值（如50件）时触发告警。关键代码：
redisTemplate.opsForZSet().add("inventory_alert", keyboardId, stockQuantity);
if (stockQuantity < THRESHOLD) {
notificationService.sendAlert(keyboardId);
}
预警机制使缺货问题发生率从每月15次降至2次以下。
4.3 操作日志追踪：通过AOP切面记录关键操作，日志表结构包含操作人、时间、操作类型、操作内容。示例日志：
2023-10-15 14:30:22 | 张三 | 入库操作 | 机械键盘G80-2023批次号：20231015001，数量：200
五、系统测试与部署流程
测试环节采用分层策略：单元测试覆盖核心服务（如库存更新逻辑），使用JUnit 5+Mockito；接口测试通过Postman验证12个关键接口；压力测试使用JMeter模拟300并发用户，持续2小时，系统平均响应时间保持在200ms内，错误率低于0.1%。部署流程分为三个阶段：
- 开发环境：本地运行（IntelliJ + Maven）
- 测试环境：通过Jenkins自动构建，部署至内网测试服务器
- 生产环境：使用Docker Compose启动服务，配置负载均衡（Nginx）和健康检查
生产环境采用蓝绿部署策略，确保系统更新零停机，2023年Q4完成3次版本迭代，平均部署时间从2小时缩短至25分钟。
六、性能优化与扩展性设计
针对高并发场景，实施以下优化：
- 数据库连接池：使用HikariCP替代默认连接池，连接获取速度提升50%
- 缓存穿透防护：通过布隆过滤器（Bloom Filter）拦截无效查询，减少数据库压力
- 异步处理：将入库日志写入操作改为异步（RabbitMQ），提升主流程响应速度
扩展性设计方面，系统采用微服务思想将核心功能模块（库存管理、报表生成）解耦，未来可独立扩展为独立服务。通过定义标准化的REST API，实现与企业微信、钉钉等办公系统的无缝对接，目前已完成与钉钉考勤系统的集成，实现入库操作自动同步至考勤记录。
