企业官网建设流程全解析

1. 项目背景与核心价值

作为一名长期从事医药电商系统开发的工程师，我深知网上购药系统与传统电商平台存在本质差异。这个基于SpringBoot的毕业设计项目看似简单，实则涉及医药行业的特殊合规要求、药品数据管理的专业性以及用户健康信息保护的敏感性。

医药电商行业近年来保持年均25%以上的增速，但市面上80%的教学系统都忽略了药品管理的特殊性。这个项目最大的价值在于：它要求开发者真正理解药品SKU管理、处方药审核流程、医保对接规范等专业领域知识，而不仅仅是实现普通的购物车功能。我在2018年参与某连锁药房线上系统改造时，就曾因初期忽视这些细节导致项目返工。

2. 系统架构设计解析

2.1 技术栈选型依据

选择SpringBoot + MyBatis Plus组合主要基于三个实际考量：

1. 快速迭代需求：药品管理政策变化频繁（如2020年处方药销售新规），需要框架支持快速调整
2. 高并发场景：疫情期间某医药平台峰值QPS达到3000+，SpringBoot的异步处理能力更可靠
3. 监管合规要求：MyBatis Plus的审计注解能自动记录药品数据修改日志，满足GSP规范

// 药品库存审计日志示例 @EntityListeners(AuditingEntityListener.class) public class DrugStock { @CreatedBy private String createdBy; @LastModifiedDate private LocalDateTime updateTime; }

2.2 核心模块划分

系统采用六层隔离架构（见下表），这种设计源于我在2019年某医药B2B项目中的数据泄露教训：

3. 药品数据管理实现

3.1 特殊字段设计

药品数据库表需要包含教学系统中常忽略的关键字段：

CREATE TABLE `drug_info` ( `drug_id` varchar(20) NOT NULL COMMENT '国药准字号码', `storage_condition` enum('常温','阴凉','冷藏','冷冻') NOT NULL, `is_prescription` tinyint(1) NOT NULL COMMENT '是否处方药', `approval_number` varchar(50) NOT NULL COMMENT '批准文号', `medical_insurance` json DEFAULT NULL COMMENT '医保信息', `adverse_reaction` text COMMENT '不良反应', PRIMARY KEY (`drug_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

3.2 药品图片处理要点

药品图片需满足：

1. 最小分辨率800x800像素（便于识别小字说明书）
2. 保存原始拍摄时间戳（防伪要求）
3. 采用CMYK色彩模式（保证印刷品颜色准确）

使用Thumbnailator库处理时需注意：

Thumbnails.of(originalFile) .size(800, 800) .outputFormat("jpg") .outputQuality(1.0) .preserveMetadata() // 保留EXIF信息 .toFile(outputFile);

4. 处方药销售流程实现

4.1 审核工作流设计

处方审核必须包含五个状态转换（见图1），这个流程来自某三甲医院药房的实际操作规范：

stateDiagram-v2 [*] --> 待提交 待提交 --> 待审核: 用户提交 待审核 --> 已驳回: 药师拒绝 待审核 --> 待支付: 药师通过 待支付 --> 已取消: 超时未付 待支付 --> 配货中: 完成支付

4.2 敏感操作日志规范

所有处方相关操作必须记录不可篡改日志：

@Aspect @Component public class PrescriptionLogAspect { @AfterReturning("execution(* com.pharmacy..*(..)) && @annotation(com.pharmacy.annotation.Auditable)") public void logAuditAction(JoinPoint jp) { // 使用国密SM3哈希算法存储操作记录 String digest = SM3Digest.digest(jp.getArgs()); auditLogRepository.save(new AuditLog( SecurityContext.getUserId(), digest, DeviceFingerprint.get() )); } }

5. 性能优化实战技巧

5.1 药品搜索优化

药品名称搜索需要支持：

• 通用名/商品名/拼音首字母搜索
• 相似药品推荐（基于ATC编码）
• 热词缓存更新策略

Elasticsearch索引配置示例：

{ "settings": { "analysis": { "analyzer": { "pinyin_analyzer": { "tokenizer": "my_pinyin" } } } }, "mappings": { "properties": { "drug_name": { "type": "text", "analyzer": "pinyin_analyzer", "fields": { "keyword": { "type": "keyword" } } } } } }

5.2 库存扣减方案

采用二阶段库存预留机制解决超卖问题：

1. 下单时预占库存（状态为HOLD）
2. 支付成功后实际扣减
3. 30分钟未支付自动释放

分布式锁实现关键代码：

public boolean lockStock(String drugId, int quantity) { String lockKey = "stock_lock:" + drugId; String requestId = UUID.randomUUID().toString(); try { Boolean result = redisTemplate.opsForValue() .setIfAbsent(lockKey, requestId, 30, TimeUnit.SECONDS); if (Boolean.TRUE.equals(result)) { // 执行库存预占操作 return stockService.holdStock(drugId, quantity); } } finally { // 使用Lua脚本保证原子性 String script = "if redis.call('get', KEYS[1]) == ARGV[1] then return redis.call('del', KEYS[1]) else return 0 end"; redisTemplate.execute( new DefaultRedisScript<>(script, Long.class), Collections.singletonList(lockKey), requestId ); } return false; }

6. 合规性关键实现

6.1 年龄验证机制

根据《药品网络销售监督管理办法》，需对购买特定药品的用户进行年龄验证：

public void validatePurchaseAge(User user, Drug drug) { if (drug.getCategory().equals(Category.RX) && ChronoUnit.YEARS.between( user.getBirthday(), LocalDate.now() ) < 18) { throw new IllegalOperationException("未成年人禁止购买处方药"); } // 特殊药品额外验证 if (drug.getControlType().equals(ControlType.NARCOTIC)) { identityService.verifyRealName(user.getIdCard()); } }

6.2 数据加密方案

采用分级加密策略保护敏感数据：

7. 测试环节特别注意事项

7.1 药品数据验证

必须建立的测试用例包括：

1. 药品批准文号格式校验（国药准字H/Z/S+8位数字）
2. 处方药与非处方药分类逻辑
3. 库存扣减与回滚的并发测试

JUnit测试示例：

@Test @Transactional public void testDrugApprovalNumberFormat() { Drug drug = new Drug() .setDrugId("国药准字H12345678") .setDrugName("测试药品"); drugRepository.save(drug); Drug saved = drugRepository.findById(drug.getDrugId()).get(); assertTrue(saved.getDrugId().matches("^国药准字[HZS]\\d{8}$")); }

7.2 支付流程测试

医药电商特有的测试场景：

1. 医保卡支付与自费支付混合结算
2. 处方审核失败时的支付回退
3. 冷链药品的运费计算规则

使用TestContainers进行集成测试：

@Testcontainers class PaymentServiceTest { @Container static MySQLContainer<?> mysql = new MySQLContainer<>("mysql:8.0"); @DynamicPropertySource static void configureProperties(DynamicPropertyRegistry registry) { registry.add("spring.datasource.url", mysql::getJdbcUrl); } @Test void testMedicalInsurancePayment() { // 测试医保分解计算逻辑 } }

8. 部署上线关键步骤

8.1 医药行业特有要求

1. 服务器必须部署在境内（根据《药品网络销售管理办法》）
2. 数据库需要每天备份并加密存储（保留至少5年）
3. 所有管理员操作需要双因素认证

8.2 监控指标配置

除常规指标外，需特别监控：

• 处方审核平均耗时
• 药品库存准确率
• 冷链药品配送温度异常事件

Prometheus配置示例：

- job_name: 'pharmacy' metrics_path: '/actuator/prometheus' static_configs: - targets: ['app:8080'] relabel_configs: - source_labels: [__meta_docker_container_name] regex: '.*pharmacy.*' action: keep

9. 项目扩展方向建议

1. 对接互联网医院问诊系统（需遵循《互联网诊疗管理办法》）
2. 增加药品不良反应上报功能（符合FDA 21 CFR Part 11要求）
3. 开发药师在线咨询模块（注意保存聊天记录至少2年）

10. 真实项目经验分享

在2021年某医药电商项目中，我们曾遇到处方图片上传性能问题。最终解决方案是：

1. 使用WebP格式替代JPEG（体积减少40%）
2. 对图片进行分区存储（处方正文与背景分离压缩）
3. 添加智能裁剪功能（自动聚焦药品信息区域）

核心优化代码：

public BufferedImage optimizePrescriptionImage(MultipartFile file) { BufferedImage img = ImageIO.read(file.getInputStream()); // 使用OpenCV检测文字区域 Mat src = Imgcodecs.imdecode(new MatOfByte(file.getBytes()), Imgcodecs.IMREAD_COLOR); Mat gray = new Mat(); Imgproc.cvtColor(src, gray, Imgproc.COLOR_BGR2GRAY); // 应用自适应阈值和轮廓检测 Mat binary = new Mat(); Imgproc.adaptiveThreshold(gray, binary, 255, Imgproc.ADAPTIVE_THRESH_GAUSSIAN_C, Imgproc.THRESH_BINARY, 11, 2); // 裁剪关键区域 Rect roi = findTextROI(binary); return img.getSubimage(roi.x, roi.y, roi.width, roi.height); }