CLAUDE.md

此文件为Claude Code (claude.ai/code) 提供在此代码库中工作的指导。

项目概述

这是一个渤海保险报价API模块，属于大型多模块Maven保险报价服务项目的一部分。该项目包含多个保险公司集成。

架构

父级结构: 多级Maven层次结构 (jzg → tenant → insurance → quotation-bohai)
框架: Spring Boot 3.0.0 + WebFlux 响应式编程
数据库: MongoDB集成 (Spring Data MongoDB)
API风格: RESTful API，使用FastJSON进行JSON序列化
安全: RSA加密和数字签名用于API通信

构建命令

# 编译项目
mvn compile

# 打包（跳过测试）
mvn package -DskipTests

# 清理构建
mvn clean package

# 安装到本地仓库
mvn install

关键组件

BoHaiRequestApiComponent: 主API客户端组件，处理所有渤海保险API调用
BoHaiApiOrderService: MongoDB服务层，用于持久化报价数据
BohaiApiConfigurationProperties: 渤海API端点配置属性
多个枚举类: 丰富的保险领域模型枚举类型

开发说明

Java版本: 17
依赖: 重度依赖quotation-commons模块的共享功能
加密: 使用自定义RSA加密工具 (BoHaiEncrypted, SignatureUtils)
日志: InsuranceLog用于结构化保险特定日志
错误处理: 自定义SystemException处理业务逻辑错误

API集成模式

模块遵循一致的渤海API集成模式：

使用正确的枚举构建请求体
RSA加密和签名生成
带自定义头的HTTP POST请求
响应解密和验证
成功报价的MongoDB持久化

常见开发任务

添加新的渤海API端点
扩展新保险产品的枚举类型
修改加密/解密逻辑
更新MongoDB持久化模型
与quotation-commons共享组件集成