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

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

项目概述

这是一个基于Maven的Java Spring Boot微服务模块，专门用于华农保险的报价服务集成。

技术栈

• 框架: Spring Boot 3.0.0
• Java版本: Java 17
• 构建工具: Maven
• 数据存储: MongoDB (通过Spring Data MongoDB)
• 网络通信: WebFlux reactive programming
• 工具库: Hutool, Apache Commons

开发命令

构建命令

# 构建当前模块
mvn clean compile

# 包含测试的完整构建
mvn clean package

# 安装到本地Maven仓库
mvn clean install

# 运行Spring Boot应用
mvn spring-boot:run

模块特定构建

# 从根目录构建特定模块
mvn clean compile -pl quotation-huanong

# 构建并跳过测试
mvn clean package -pl quotation-huanong -DskipTests

项目结构

• src/main/java/com/jzg/quotation/huanong/ - 主要Java源代码
  • crawler/ - 网络爬虫和API集成组件
  • component/ - 业务组件
  • entity/ - 数据实体和DTO
  • constant/ - 常量和枚举
  • service/ - 业务服务层
  • controller/ - REST API控制器

架构特点

1. 爬虫集成: 与华农保险API的深度集成
2. 响应式编程: 使用WebFlux进行非阻塞IO操作
3. MongoDB存储: 会话数据和报价结果的持久化
4. 配置驱动: 通过配置参数控制API行为
5. 错误处理: 完善的异常处理和状态码管理

重要依赖

• quotation-commons - 共享报价功能模块
• com.jzg.commons - 核心公共库
• Spring Data MongoDB - 数据库操作
• Spring WebFlux - 响应式Web框架
• Hutool - 工具类库

开发注意事项

• 遵循现有的代码规范和包结构
• 使用响应式编程模式（Mono/Flux）
• 保持与quotation-commons模块的兼容性
• 配置参数通过HuaNongCrawlerConfigureParameters管理
• API调用使用HuaNongCrawlerRequestComponent组件