b端医疗物资进销存管理后台-医疗耗材物资管理系统

一、立项背景与目标：医院耗材种类多、流转频繁，传统人工台账易出错、库存不透明、效期难追溯。本系统旨在实现医疗耗材从采购、入库、出库到库存预警的全流程数字化管理，提升物资周转效率与监管合规性。

二、核心功能模块：系统包含首页仪表盘（指标卡片+出入库趋势图+预警列表）、耗材与分类管理、供应商管理、采购申请与审批、入库管理、出库管理、库存查询与出入库流水、库存预警（库存不足/库存过多/近效期）、报表统计（出入库汇总、科室领用统计、耗材消耗TOP10、支持导出Excel）、系统设置（用户/科室/角色管理）等模块，并按角色分级授权（系统管理员/仓库管理员/科室人员）。

三、业务流程与功能路径：科室提交采购申请→管理员审批通过后一键生成入库单→入库审核自动增加库存并登记批次与有效期→科室领用出库时按先进先出（FIFO）扣减批次库存→系统实时核算库存并自动触发低库存与近效期预警→报表模块汇总出入库与科室领用数据供决策分析。全流程单据编号可追溯，库存变动逐笔留痕，账实一致。

一、整体架构与设计思路：项目采用前后端分离架构。前端基于 Vue3 + Vite5 + Element Plus + Pinia + Vue Router + Axios + ECharts，全部页面使用 Composition API（script setup）组件化开发，Axios 统一拦截器处理鉴权与错误，路由守卫+角色映射实现菜单与页面级权限。后端基于 ASP.NET Core 8 Web API，分为 Api（控制器）、Service（业务逻辑）、Core（实体与DTO）、Infrastructure（EF Core DbContext与迁移）四层；数据库为 SQL Server，采用 Code First + Migrations 管理表结构。设计上统一 ApiResult 响应封装、全局异常中间件、JWT 认证、全表软删除、库存变动流水留痕、出库按先进先出（FIFO）扣减。

二、我负责的模块与结果：独立负责全栈开发。前端完成登录、仪表盘、耗材/分类/供应商、采购申请与审批、入库、出库、库存/流水/预警、报表、系统设置等 12 个模块约 20 个页面；后端完成 5 组控制器约 40 个接口、14 张数据表；打通"采购申请→审批→一键生成入库单→审核加库存→FIFO 出库→库存预警→报表统计与CSV导出"完整业务闭环；实现管理员/仓库管理员/科室人员三级权限；后端构建 0 错误 0 警告，接口平均响应 200ms 内。

三、遇到的难点、坑与解决方案：1）用户表命名与 SQL Server 系统视图 sysusers 冲突导致建表失败，通过 [Table("AppUsers")] 显式映射表名解决；2）SQL Server 2008 R2 不支持 EF 批量语句，配置 MaxBatchSize(1) 兼容；3）Vite8 的 rolldown 原生绑定在 Windows 缺失导致启动报错，降级锁定 Vite5 稳定版解决；4）出库扣减需保证账实一致，采用按有效期+创建时间排序的 FIFO 逐批扣减，库存不足抛异常回滚，并同步更新批次台账、耗材总库存、变动流水三处；5）前端导出 Excel 中文乱码，通过 CSV 添加 BOM 头并转义逗号/引号/换行解决。