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

CLAUDE.md

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

项目结构

这是一个基于Maven的Java Spring Boot微服务项目，用于保险报价服务。项目组织如下：

• 根目录: D:\project\jzg\tenant\insurance\ - 父级Maven模块
• 模块: 多个保险报价服务（quotation-dajia、quotation-taikang、quotation-summary等）
• 公共模块: 共享模块（quotation-commons、commons核心库）

关键技术

• 框架: Spring Boot 3.0.0 with WebFlux
• 构建工具: Maven with Java 17
• 数据库: MongoDB with Spring Data MongoDB
• API: RESTful APIs with OpenFeign服务通信
• 文档: Swagger/OpenAPI注解
• 工具库: Hutool crypto、Apache Commons Lang

开发命令

构建和运行

# 构建特定模块（例如quotation-dajia）
mvn clean compile -pl quotation-dajia

# 包含测试的构建
mvn clean package -pl quotation-dajia

# 运行Spring Boot应用（从模块目录）
mvn spring-boot:run

# 安装到本地仓库
mvn clean install -pl quotation-dajia

测试

# 运行特定模块的测试
mvn test -pl quotation-dajia

# 运行特定测试类
mvn test -pl quotation-dajia -Dtest=ClassName

# 运行测试覆盖率检查
mvn test -pl quotation-dajia -Djacoco.skip=false

依赖管理

# 检查依赖更新
mvn versions:display-dependency-updates -pl quotation-dajia

# 分析依赖关系
mvn dependency:tree -pl quotation-dajia

架构模式

1. 微服务架构: 每个保险提供商都有独立的报价模块
2. 共享公共模块: 通用功能在quotation-commons模块中
3. MongoDB集成: 使用Spring Data MongoDB仓库和模式验证
4. Feign客户端: 通过OpenFeign进行服务间通信
5. REST控制器: 标准的Spring MVC控制器，带有Swagger文档

模块结构

每个报价模块通常包含：

• src/main/java/com/jzg/quotation/[provider]/ - Java源代码
• API组件、常量、构建器
• MongoDB仓库接口
• 配置属性
• 与外部保险API的集成

重要说明

• 证书管理: 某些模块需要安装HTTPS证书（参见文档）
• MongoDB模式: 使用复杂的模式验证来管理会话和API数据
• 保险集成: 模块与各种保险提供商API集成
• 公共依赖: 依赖quotation-commons和com.jzg.commons模块