# sfbx

**Repository Path**: ye-weiling/sfbx

## Basic Information

- **Project Name**: sfbx
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-18
- **Last Updated**: 2025-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 四方保险云平台 (sfbx-cloud) 项目介绍

## 1. 项目概述

四方保险云平台（sfbx-cloud）是一个基于Spring Cloud微服务架构的保险业务综合管理系统。该平台采用模块化设计，实现了保险业务全流程的数字化管理，包括保险产品管理、保单处理、交易支付、用户权限、文件管理、数据埋点等核心功能。系统支持容器化部署，具备高可用性、可扩展性和安全性等企业级特性。

## 2. 系统架构

### 2.1 整体架构

![架构图](系统架构图.png)

系统采用典型的微服务架构，包含以下核心组件：

- **服务注册与发现**：基于Nacos实现微服务的注册发现和配置管理
- **网关层**：提供统一的API入口，实现路由转发、权限控制等功能
- **业务服务层**：各功能模块独立部署，通过Feign实现服务间调用
- **数据持久层**：使用MySQL作为主数据库，Redis提供缓存支持
- **消息中间件**：基于RabbitMQ实现服务间异步通信
- **分布式事务**：采用Seata保证分布式事务一致性
- **任务调度**：基于XXL-Job实现分布式任务调度

### 2.2 部署架构

系统支持Docker容器化部署，通过docker-compose编排管理各服务组件，包括MySQL、Nacos、Seata、RabbitMQ、Redis、XXL-Job等基础设施服务和各业务微服务。

## 3. 技术栈

| 技术类别 | 技术选型 | 版本 | 用途 |
|---------|---------|------|------|
| 基础框架 | Spring Boot | 2.7.10 | 应用基础框架 |
| 微服务框架 | Spring Cloud | 2021.0.6 | 微服务核心框架 |
| 微服务组件 | Spring Cloud Alibaba | 2021.0.1.0 | 微服务生态组件 |
| ORM框架 | MyBatis-Plus | 3.4.0 | 数据库访问框架 |
| 服务注册发现 | Nacos | 2.0.2 | 服务注册、发现与配置管理 |
| 分布式事务 | Seata | 1.5.2 | 分布式事务协调 |
| 消息队列 | RabbitMQ | 3.8.3 | 异步消息处理 |
| 缓存 | Redis | 5.0.0 | 数据缓存 |
| 数据库 | MySQL | 5.7 | 数据持久化 |
| 任务调度 | XXL-Job | 2.1.2 | 分布式任务调度 |
| API文档 | Knife4j | 3.0.3 | API接口文档 |
| 文件存储 | 七牛云SDK | 7.7.0 | 对象存储服务 |
| 支付接口 | 支付宝SDK、微信支付SDK | 4.38.61.ALL、0.4.8 | 支付功能集成 |
| 容器化 | Docker | - | 应用容器化部署 |
| 工具库 | Hutool、Guava、Fastjson | 5.8.10、23.0、1.2.73 | 通用工具集 |

## 4. 模块功能介绍

### 4.1 基础框架模块 (sfbx-framework)

基础框架模块是整个系统的技术底座，提供各类通用技术组件和功能支持，主要包含以下子模块：

- **framework-commons**：通用工具类库，提供各类常用工具方法
- **framework-web**：Web层基础组件，包含全局异常处理、请求拦截等
- **framework-mybatis-plus**：数据库访问增强组件，基于MyBatis-Plus扩展
- **framework-redis**：Redis缓存组件，提供缓存操作封装
- **framework-rabbitmq**：消息队列组件，封装RabbitMQ操作
- **framework-feign**：服务调用组件，基于Feign封装
- **framework-gateway**：网关基础组件
- **framework-seata**：分布式事务组件
- **framework-xxl-job**：任务调度组件
- **framework-knife4j-web/gateway**：API文档组件
- **framework-rule-base**：规则引擎基础组件
- **framework-influxdb**：时序数据库组件
- **framework-wenxin**：AI相关组件

### 4.2 保险业务模块 (sfbx-insurance)

保险业务模块是系统的核心业务模块，负责保险产品管理、保单处理等核心功能：

- **insurance-mgt**：保险后台管理系统，提供产品管理、保单审核等管理功能
- **insurance-app**：保险小程序管理系统，支持移动端业务处理
- **insurance-service**：保险核心业务服务层，封装业务逻辑
- **insurance-interface**：保险业务接口定义

### 4.3 权限处理模块 (sfbx-security)

权限处理模块负责系统的认证授权、用户管理等安全相关功能：

- **security-interface**：权限相关接口定义
- **security-oauth**：认证授权模块，基于OAuth2实现
- **security-web**：权限管理Web层，提供用户、角色、权限管理功能

### 4.4 网关模块 (sfbx-gateway)

网关模块作为系统的统一入口，负责请求路由、负载均衡、安全过滤等功能：

- **gateway-mgt**：管理后台网关，处理管理系统请求
- **gateway-app**：应用前台网关，处理客户端请求

### 4.5 交易支付模块 (sfbx-trade)

交易支付模块负责系统的支付处理、订单管理等功能：

- **trade-interface**：交易相关接口定义
- **trade-web**：交易支付Web层，集成支付宝、微信支付等支付渠道

### 4.6 规则引擎模块 (sfbx-rule)

规则引擎模块提供业务规则的配置、管理和执行能力：

- **rule-client**：规则引擎客户端，提供规则调用能力
- **rule-web**：规则引擎管理系统，支持规则配置和管理

### 4.7 文件处理模块 (sfbx-file)

文件处理模块负责系统的文件上传、下载、存储等功能：

- **file-interface**：文件处理接口定义
- **file-web**：文件处理Web层，支持文件上传下载和管理

### 4.8 数据字典模块 (sfbx-dict)

数据字典模块提供系统基础数据的统一管理：

- **dict-interface**：数据字典接口定义
- **dict-web**：数据字典管理系统

### 4.9 数据埋点模块 (sfbx-points)

数据埋点模块负责系统运行数据的采集和分析：

- **points-interface**：数据埋点接口定义
- **points-web**：数据埋点Web层，处理数据采集和上报

### 4.10 短信处理模块 (sfbx-sms)

短信处理模块负责系统的短信发送功能：

- **sms-interface**：短信服务接口定义
- **sms-web**：短信服务Web层，集成短信服务商API

### 4.11 任务监听模块 (sfbx-task)

任务监听模块负责系统的异步任务处理和事件监听：

- **task-job**：任务调度执行模块
- **task-listener**：事件监听器模块

### 4.12 HTTP客户端模块 (sfbx-apache-httpclient)

HTTP客户端模块提供系统的HTTP请求能力封装，基于Apache HttpClient实现。

## 5. 关键业务流程

### 5.1 保险投保流程

1. 用户通过前端选择保险产品
2. 填写投保信息并提交
3. 系统进行规则校验和风险评估
4. 生成投保单并发起支付请求
5. 用户完成支付
6. 系统生成正式保单并发送通知

### 5.2 理赔申请流程

1. 用户提交理赔申请及相关材料
2. 系统进行初步审核和材料完整性检查
3. 理赔人员进行人工审核
4. 审核通过后进行赔付处理
5. 完成赔付并发送通知

## 6. 系统特点

1. **模块化设计**：各业务功能模块化，便于维护和扩展
2. **微服务架构**：基于Spring Cloud实现服务解耦和独立部署
3. **容器化部署**：支持Docker容器化部署，简化运维
4. **高可用性**：关键服务集群部署，支持故障转移
5. **安全性**：完善的认证授权机制，保障数据安全
6. **可扩展性**：支持横向扩展，应对业务增长

## 7. 部署说明

系统采用Docker Compose进行容器化部署，主要部署步骤如下：

1. 配置环境变量和相关配置文件
2. 执行docker-compose up命令启动所有服务
3. 访问各服务的Web界面进行初始化配置

详细部署文档请参考《部署指南》。

## 8. 开发指南

### 8.1 开发环境要求

- JDK 1.8+
- Maven 3.6+
- IntelliJ IDEA 2020.3+
- Docker Desktop

### 8.2 项目结构说明

项目采用多模块Maven结构，按照功能划分为多个子模块，各模块间通过接口进行调用。

### 8.3 编码规范

请参考《编码规范文档》。

## 9. 总结

四方保险云平台是一个功能完善、架构先进的保险业务综合管理系统，采用现代化的微服务架构和技术栈，能够满足保险业务的各种需求，为保险公司提供高效、可靠的IT支撑。