jzg/tenant/insurance/quotation-zijin/CLAUDE.md

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通信的数据传输对象
• 策略模式: 不同保险公司的不同实现

业务领域

核心业务流程

1. 车辆报价流程:

   • 车辆信息验证和爬取
   • 基于风险因素的保费计算
   • 报价生成和展示
   • 保单定制选项

2. 订单管理流程:

   • 订单创建和跟踪
   • 保费计算和验证
   • 支付链接生成
   • 保单文档生成
   • 状态更新和通知

3. 客户管理流程:

   • 客户信息验证
   • 投保人和被保险人管理
   • 文档上传和验证
   • 沟通和通知

主要保险类型

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

核心类和接口

重要服务类

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

关键请求/响应DTO

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

配置和枚举

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

开发指南

保险公司集成工作

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

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

数据库操作

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

外部集成点

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

错误处理

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

测试

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

mvn test
mvn surefire:test