一、系统概述\n\nJSP中医馆药材信息管理系统是一套面向中小型中医馆、中药房及诊所的药材信息化管理软件。系统基于Java Web技术栈开发，采用JSP+Servlet+JavaBean的经典MVC模式，结合MySQL数据库实现药材的入库、出库、库存盘点、供应商管理、处方调剂等核心业务功能。\n\n项目编号可标识为6j0at，适合作为计算机专业毕业设计、课程设计或软件工程实训项目使用。\n\n## 二、开发环境与技术选型\n\n### 2.1 开发环境\n- 操作系统：Windows 10/11 或 Linux（CentOS 7+/Ubuntu 20.04+）\n- JDK版本：JDK 1.8 或以上\n- Web服务器：Apache Tomcat 8.5/9.0\n- 数据库：MySQL 5.7 / 8.0\n- 开发工具：Eclipse / IntelliJ IDEA / MyEclipse\n- 项目管理：Maven 3.6+\n- 浏览器：Chrome / Edge / Firefox\n\n### 2.2 技术栈\n- 前端：JSP、HTML5、CSS3、JavaScript、jQuery、Bootstrap\n- 后端：Java Servlet、JSP、JavaBean、Filter、Listener\n- 数据库：MySQL + JDBC（可选用Druid/C3P0连接池）\n- 架构模式：MVC三层架构（表现层、业务逻辑层、数据访问层）\n\n## 三、系统功能模块设计\n\n系统主要分为四大角色：系统管理员、药房管理人员、中医师、普通员工。\n\n### 3.1 核心功能模块\n1. 用户与权限管理：用户注册、登录、角色分配、密码修改、权限控制。\n2. 药材基础信息管理：药材编号、名称、别名、产地、性味归经、功效、价格、库存上下限、计量单位。\n3. 药材入库管理：入库单录入、供应商信息、批次、生产日期、有效期、数量、单价、总价。\n4. 药材出库管理：处方调剂出库、领用出库、出库审核、出库记录。\n5. 库存管理：实时库存查询、库存预警（低于下限/接近效期）、库存盘点、库存台账。\n6. 供应商管理：供应商档案、联系方式、供货记录、评价。\n7. 处方管理：处方录入、审核、调剂出库、处方模板、病历关联。\n8. 统计报表：进销存报表、库存余额表、销售排行、药材用量分析。\n9. 系统日志：操作日志、登录日志、异常日志。\n\n### 3.2 GPS/流程设计\n麻黄等特殊药材的出库需二次审核；贵细药材库存变动会实时触发报警；处方调剂与库存出库联动，自动减少库存并计入出库明细。\n\n## 四、数据库设计\n\n### 4.1 数据库E-R要点\n核心实体包括：用户（user）、角色（role）、权限（permission）、药材（medicine）、供应商（supplier）、入库单（instock）、入库明细（instockdetail）、出库单（outstock）、出库明细（outstockdetail）、处方（prescription）、处方明细（prescriptiondetail）、库存（stock）、报警记录（alarm）、系统日志（syslog）。\n\n### 4.2 主要数据表结构（节选）\n\nmedicine 药材表\n- medid：主键，药材编号\n- medname：药材名称\n- alias：别名\n- origin：产地\n- nature：性味\n- meridian：归经\n- efficacy：功效\n- unit：单位\n- price：单价\n- stocklower：库存下限\n- stockupper：库存上限\n- createtime：创建时间\n- status：状态\n\ninstock 入库表\n- inid：主键\n- supplierid：供应商\n- intime：入库时间\n- operator：经办人\n- totalamount：总金额\n- remark：备注\n\ninstockdetail 入库明细\n- detailid：主键\n- inid：入库单号\n- medid：药材编号\n- batchno：批次\n- quantity：数量\n- price：单价\n- produceddate：生产日期\n- expiredate：有效期至\n\noutstock 出库表\n- outid：主键\n- outtype：出库类型（处方/领用）\n- outtime：出库时间\n- operator：经办人\n- receiver：领用人\n- remark：备注\n\nstock 库存表\n- stockid：主键\n- medid：药材编号\n- batchno：批次\n- inventory：当前库存\n- updatetime：更新时间\n\nuser 用户表\n- userid：主键\n- username：登录名\n- password：密码（MD5/SHA 加密）\n- realname：真实姓名\n- roleid：角色ID\n- phone：手机\n- status：状态\n\nprescription 处方表\n- presid：主键\n- patientname：患者姓名\n- doctorid：开方医生\n- prestime：开方时间\n- status：状态（待审/已审/已调剂/已取消）\n- remark：备注\n\n## 五、程序源码结构\n\n项目采用标准 Java Web 目录结构：\n\n`\nherb-system/\n├── src/\n│ ├── com.herb.dao // 数据访问层\n│ ├── com.herb.entity // 实体类\n│ ├── com.herb.service // 业务层\n│ ├── com.herb.servlet // 控制器\n│ ├── com.herb.filter // 过滤器（编码、权限）\n│ ├── com.herb.util // 工具类（DBUtil、MD5加密、分页）\n│ └── db.properties // 数据库连接配置\n├── WebContent/\n│ ├── css/ js/ images/ // 静态资源\n│ ├── jsp/ // JSP 页面\n│ │ ├── login.jsp\n│ │ ├── index.jsp\n│ │ ├── medicinelist.jsp\n│ │ ├── instockadd.jsp\n│ │ ├── outstocklist.jsp\n│ │ ├── prescriptionlist.jsp\n│ │ └── report.jsp\n│ └── WEB-INF/\n│ ├── web.xml // 部署描述符\n│ └── lib/ // 依赖jar（如mysql-connector、jstl、druid）\n└── sql/herb.sql // 数据库脚本\n`\n\n主要关键代码段包括：JDBC 工具类连接与关闭、分页查询封装、日期与金额格式化、事务控制入库与出库操作。\n\n## 六、调试部署实施步骤\n\n### 6.1 数据库部署\n1. 启动 MySQL，打开命令行或Navicat，创建数据库：\n `sql\n CREATE DATABASE herbdb DEFAULT CHARACTER SET utf8mb4;\n `\n2. 导入 sql/herb.sql，自动建表并插入初始测试数据。\n\n### 6.2 源码导入与配置\n1. IDE Intel IDEA 中选择“Import Project”→“Maven”或“Eclipse项目”，导入工程。\n2. 修改 db.properties 中的数据库连接地址、用户名、密码。\使用 database name herbdb\n`properties\njdbc.driver=com.mysql.cj.jdbc.Driver\njdbc.url=jdbc:mysql://localhost:3306/herbdb?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai\njdbc.username=root\njdbc.password=root\n`\n3. 配置项目SDK为JDK 1.8；在Build Path中确认 mysql-connector-java、jstl、servlet-api 已被依赖。\n\n### ·6.3 服务器（Tomcat）配置\n1. 添加 Tomcat Runtime 到工程，设置端口 808¥0（如被占用可改为 8083）。\n2. 配置 Application context= /herb。\n\n### 6.4 常见问题与调试要点\n- 500 错误 ClassNotFound：检查 .jar 是否放入WebContent/WEB-INF/lib，且Build Path 已添加。\n- 中文乱码：请求与响应过滤器统一设置为 UTF-8，并确认数据库连接串带characterEncoding=utf8。\n- 登录数据库密码报错：MySQL 8 需使用 com.mysql.cj.jdbc.Driver 并设置 serverTimezone=\。亚洲/上都常可在实际开发中被误设因排还是显示，均可修正是因为 Asia\亚洲时可出现占位——可能带有转义换.4\x59;\