# zhendai

**Repository Path**: hypercmf/zhendai

## Basic Information

- **Project Name**: zhendai
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-31
- **Last Updated**: 2026-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h4 align="center">基于 Vue/Element UI 和 Spring Boot/Spring Cloud & Alibaba 前后端分离的分布式微服务架构</h4>

## 平台简介

* 采用前后端分离的模式，微服务版本前端(基于 [RuoYi-Vue](https://gitee.com/y_project/RuoYi-Vue))。
* 后端采用Spring Boot、Spring Cloud & Alibaba。
* 注册中心、配置中心选型Nacos，权限认证使用Redis。
* 流量控制框架选型Sentinel，分布式事务选型Seata。
* 本仓库在若依微服务基础上扩展**贷超（daichao）**与**通知/短信网关（notify）**业务模块。

# 版本分支

后端项目提供 Spring Boot 4.1.0 。
前端项目提供 Vue3  JavaScript 版本（本仓库可参考 `RuoYi-Cloud-Vue3`）。

## 系统模块

~~~
com.ruoyi
├── ruoyi-ui / RuoYi-Cloud-Vue3   // 前端框架 [80]
├── ruoyi-gateway                 // 网关模块 [8080，本地常用 8088]
├── ruoyi-auth                    // 认证中心 [9200]
├── ruoyi-api                     // 接口模块
│       └── ruoyi-api-system                          // 系统接口
├── ruoyi-common                  // 通用模块
│       └── ruoyi-common-core                         // 核心模块
│       └── ruoyi-common-datascope                    // 权限范围
│       └── ruoyi-common-datasource                   // 多数据源
│       └── ruoyi-common-log                          // 日志记录
│       └── ruoyi-common-redis                        // 缓存服务
│       └── ruoyi-common-seata                        // 分布式事务
│       └── ruoyi-common-security                     // 安全模块
│       └── ruoyi-common-sensitive                    // 数据脱敏
│       └── ruoyi-common-swagger                      // 系统接口
├── ruoyi-modules                 // 业务模块
│       └── ruoyi-system                              // 系统模块 [9201]
│       └── ruoyi-gen                                 // 代码生成 [9202]
│       └── ruoyi-job                                 // 定时任务 [9203]
│       └── ruoyi-daichao                             // 贷超业务 [9204]
│       └── ruoyi-notify                              // 通知/短信网关 [9205]
│       └── ruoyi-file                                // 文件服务 [9300]
├── ruoyi-visual                  // 图形化管理模块
│       └── ruoyi-visual-monitor                      // 监控中心 [9100]
├── docs/daichao                  // 贷超/通知产品与技术方案
├── sql/daichao、sql/notify       // 业务表与菜单 SQL、Nacos 说明
├──pom.xml                        // 公共依赖
~~~

### 网关路由（业务扩展）

| 前缀 | 路由 id（勿等于服务名） | 服务 | 说明 |
|------|-------------------------|------|------|
| `/auth/**` | auth-api | ruoyi-auth | 登录认证 |
| `/system/**` | system-api | ruoyi-system | 系统管理 |
| `/daichao/**` | daichao-api | ruoyi-daichao | 贷超管理 API（StripPrefix=1） |
| `/s/**` | daichao-short | ruoyi-daichao | 短链跳转（无 StripPrefix） |
| `/notify/**` | notify-api | ruoyi-notify | 短信通道等（StripPrefix=1） |

> `discovery.locator.enabled=true` 时，自定义路由 **id 不得等于** `ruoyi-system` / `ruoyi-daichao` / `ruoyi-notify` 等服务名，否则会出现 `No static resource system/user/getInfo` 一类前缀未剥离错误。详见 `sql/notify/NACOS_GATEWAY.md`、`docker/sql/update_gateway_all_envs.sql`。

## 架构图

<img src="https://oscimg.oschina.net/oscnet/up-82e9722ecb846786405a904bafcf19f73f3.png"/>

## 内置功能

1.  用户管理：用户是系统操作者，该功能主要完成系统用户配置。
2.  部门管理：配置系统组织机构（公司、部门、小组），树结构展现支持数据权限。
3.  岗位管理：配置系统用户所属担任职务。
4.  菜单管理：配置系统菜单，操作权限，按钮权限标识等。
5.  角色管理：角色菜单权限分配、设置角色按机构进行数据范围权限划分。
6.  字典管理：对系统中经常使用的一些较为固定的数据进行维护。
7.  参数管理：对系统动态配置常用参数。
8.  通知公告：系统通知公告信息发布维护。
9.  操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
10. 登录日志：系统登录日志记录查询包含登录异常。
11. 在线用户：当前系统中活跃用户状态监控。
12. 定时任务：在线（添加、修改、删除)任务调度包含执行结果日志。
13. 代码生成：前后端代码的生成（java、html、xml、sql）支持CRUD下载 。
14. 系统接口：根据业务代码自动生成相关的api接口文档。
15. 服务监控：监视当前系统CPU、内存、磁盘、堆栈等相关信息。
16. 在线构建器：拖动表单元素生成相应的HTML代码。
17. 连接池监视：监视当前系统数据库连接池状态，可进行分析SQL找出系统性能瓶颈。

## 业务扩展：贷超（ruoyi-daichao）

贷款产品聚合与导流平台能力（平台不放贷）。服务端口 **9204**，网关前缀 `/daichao/**`，短链公开跳转 `/s/{code}`。

| 能力 | 说明 | 状态（概要） |
|------|------|----------------|
| 渠道管理 | 自定义渠道 ID、类型（信息流/短信/应用市场等）、启停、扩展配置 | 已落地 |
| 银行机构 | 机构名称、Logo 上传、启停；产品可关联 | 已落地 |
| 审核流程 | 可配流程节点（如新增/上架审核）、审核人与抄送 | 已落地 |
| 产品库 | 产品 CRUD、关联机构/期限/还款方式、绑定流程与渠道、提审/审核/下架 | 已落地 |
| 短链域名 | 多域名、当前生成域切换、审计 | 已落地 |
| 短链服务 | 生成与跳转、防开放重定向；形态 `http(s)://{domain}/s/{code}` | 已落地 |
| 联登/撞库 | 开放接口骨架（验签/限流预留） | 骨架 |
| 经营分析 / 数据大盘 | 筛选维度与报表骨架、大屏漏斗与趋势 | Mock/骨架 |
| 前端 | 管理端菜单与页面（渠道/产品/审核流/短链/大盘等） | 随模块迭代 |

文档：

* 产品说明（含短信概念与计算口径）：[docs/daichao/PRODUCT_SPEC.md](docs/daichao/PRODUCT_SPEC.md)
* 架构与安全/高可用：[docs/daichao/ARCHITECTURE.md](docs/daichao/ARCHITECTURE.md)
* 开发计划：[docs/daichao/DEVELOPMENT_PLAN.md](docs/daichao/DEVELOPMENT_PLAN.md)
* 文档索引：[docs/daichao/00-README.md](docs/daichao/00-README.md)

SQL / 配置：`sql/daichao/`。

## 业务扩展：通知与短信网关（ruoyi-notify）

统一承载 **SmsGateway（多短信通道路由）** 与后续企微/小程序等 Notify；与贷超同合规目标（密钥进 Nacos、审计、阈值告警）。服务端口 **9205**，网关前缀 `/notify/**`。

| 能力 | 说明 | 状态（概要） |
|------|------|----------------|
| 短信通道管理 | 通道 CRUD、排序、默认通道、失败率/连续失败阈值、滑窗、QPS、日限额 | 进行中（管理页已有） |
| 路由与熔断 | 顺序 failover、同通道有限重试、滑窗失败率/连续失败熔断 | 设计已定，真发送待续 |
| 模板与绑定 | 内部 templateCode ↔ 各厂商模板/签名 | 表结构已备 |
| 发送记录 | 主单 + 尝试明细 | 表结构已备 |
| Provider / MQ | 多 ISV Adapter、`SMS_SEND` 队列、回执回调 | 待办 |
| 成功率告警 | 低于阈值 → 告警库 + 企微（通用 AlertService） | 设计见 ALERT_DESIGN |
| 微信多应用 | 多小程序/公众号（元数据 DB + 密钥 Nacos） | 规划中 |

产品口径（成功率/失败率/熔断公式）：[docs/daichao/PRODUCT_SPEC.md](docs/daichao/PRODUCT_SPEC.md) §4.6  
技术方案：[docs/daichao/NOTIFY_DESIGN.md](docs/daichao/NOTIFY_DESIGN.md)  
告警中心：[docs/daichao/ALERT_DESIGN.md](docs/daichao/ALERT_DESIGN.md)  
Nacos/网关：[sql/notify/NACOS_GATEWAY.md](sql/notify/NACOS_GATEWAY.md)  
SQL：`sql/notify/01_sms_channel.sql`  
前端示例：`RuoYi-Cloud-Vue3/src/views/notify/sms/channel/`

## 本地说明（摘要）

* JDK 17+；Nacos 按 **dev / test / prod** 命名空间隔离，业务配置外置，禁止只改 -dev。
* 新增服务须在三环境发布 `{服务}-{env}.yml`，并同步网关路由后**重启 ruoyi-gateway**。
* 更完整的启动步骤见仓库内 `LOCAL_STARTUP.md`（若有）。