CLAUDE.md

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

项目概述

这是一个基于Java的多模块Maven保险报价平台项目，专门专注于与紫金保险公司集成。项目采用微服务架构，使用Spring Boot 3.0和WebFlux进行响应式编程。

构建和开发命令

Maven命令

# 构建整个项目
mvn clean compile

# 安装所有依赖
mvn clean install

# 构建并运行特定模块
mvn spring-boot:run -pl quotation-zijin

# 打包用于部署
mvn clean package

# 使用Spring Boot运行特定模块
mvn spring-boot:run -pl quotation-zijin

Java版本

Java 17（源码和目标）

关键依赖

Spring Boot 3.0.0 with WebFlux
Spring Data MongoDB
MyBatis Plus
OpenFeign用于服务通信
Hutool工具库
RocketMQ消息队列
ZXing二维码处理
微信集成（commons模块）

架构

多模块结构

项目组织为多模块Maven项目：

父模块: tenant - 公共依赖和配置
业务模块: insurance - 保险相关子模块
报价模块: 每个保险公司都有自己的模块（quotation-zijin、quotation-bohai、quotation-huatai等）
公共模块: quotation-commons - 共享工具和基础类

紫金模块架构

quotation-zijin模块遵循分层架构：

API层（`com.jzg.quotation.zijin.api`）

用途: 外部API接口和业务逻辑
核心组件:
- component/: 业务组件（缓存、请求处理、错误处理）
- entity/request/: API请求DTO
- entity/response/: API响应DTO
- entity/po/: MongoDB实体
- service/: 业务服务接口和实现
- enums/: 业务枚举

爬虫层（`com.jzg.quotation.zijin.crawler`）

用途: 网页爬取和外部系统集成
核心组件:
- component/: 爬取组件
- entity/request/: 爬取请求DTO
- entity/response/: 爬取响应DTO
- service/: 爬取服务接口和实现
- enums/: 爬取相关枚举

设计模式

分层架构: API层和爬虫层清晰分离
仓储模式: 通过Spring Data MongoDB进行数据访问
服务模式: 业务逻辑封装在服务层中
DTO模式: 用于API通信的数据传输对象
策略模式: 不同保险公司的不同实现

业务领域

核心业务流程

车辆报价流程:
- 车辆信息验证和爬取
- 基于风险因素的保费计算
- 报价生成和展示
- 保单定制选项
订单管理流程:
- 订单创建和跟踪
- 保费计算和验证
- 支付链接生成
- 保单文档生成
- 状态更新和通知
客户管理流程:
- 客户信息验证
- 投保人和被保险人管理
- 文档上传和验证
- 沟通和通知

主要保险类型

交强险 (交通事故责任强制保险)
商业险 (商业保险)
车损险 (车辆损失险)
第三者责任险 (第三者责任保险)
附加险 (附加保险)

核心类和接口

重要服务类

ZiJinApiRequestComponent: 处理API请求逻辑
ZiJinCrawlerRequestComponent: 管理爬取请求
ZiJinCrawlerOrderService: 订单管理和处理
ResponseMessageAbstractHandler: 响应处理和错误处理

关键请求/响应DTO

CalculatePremiumRequest: 保费计算请求
GetAccessTokenRequest: 认证令牌请求
ModelQueryRequest: 车型查询请求
ZiJinApiOrder: MongoDB的订单实体

配置和枚举

RequestUrl: API端点枚举
RiskCodeEnum: 风险类型枚举
OrderStatusEnum: 订单状态跟踪
MotorVehicleInsuranceEnum: 保险类型枚举

开发指南

保险公司集成工作

每个保险公司模块遵循相同模式但实现不同：

外部接口的API层
外部系统集成的爬虫层
分离的请求/响应DTO
公司特定的业务逻辑

数据库操作

使用MongoDB作为主数据库
Spring Data MongoDB用于仓储操作
PO类位于entity/po/包中

外部集成点

保险公司API（紫金系统）
车辆信息爬取服务
支付网关集成
微信通知集成

错误处理

针对不同错误场景的自定义异常组件
使用ResultEnum的结构化响应处理
用于调试的全面日志记录

测试

当前结构中未找到特定的测试配置。应用标准Maven测试命令：

mvn test
mvn surefire:test

CLAUDE.md 4.3 KB History Raw