Browse Source
- 修复 OnlineFormController 中字段名匹配逻辑，移除不必要的 toLowerCase 转换 - 添加子表名称到表头记录的 childName 字段中，完善表间关联关系 - 新增 PROJECT_OVERVIEW.md 文件，详细描述 Apelet SaaS 平台架构 - 文档涵盖技术栈、模块结构、数据库架构、表关系ER图等内容 - 包含多租户数据同步流程和服务启动顺序说明 - 提供关键设计说明和权限模型介绍online-form-direct-creation
2 changed files with 504 additions and 1 deletions
@ -0,0 +1,494 @@
@@ -0,0 +1,494 @@
|
||||
# Apelet SaaS 多租户低代码平台 - 项目总览 |
||||
|
||||
## 一、项目简介 |
||||
|
||||
**Apelet SaaS** 是一个基于 **Spring Cloud 微服务架构** 的**多租户低代码开发平台**（橙单开源框架）。平台提供用户权限管理（UPMS）、在线表单设计、数据报表、工作流引擎、代码生成器、大屏可视化等核心能力，支持多租户隔离与数据同步。 |
||||
|
||||
### 技术栈 |
||||
|
||||
| 分类 | 技术 | 版本 | |
||||
|------|------|------| |
||||
| 基础框架 | Spring Boot | 2.7.10 | |
||||
| 微服务 | Spring Cloud | 2021.0.6 | |
||||
| 微服务 | Spring Cloud Alibaba | 2021.1 | |
||||
| 注册/配置中心 | Nacos | 1.3.1 | |
||||
| 网关 | Spring Cloud Gateway | - | |
||||
| 认证授权 | Spring Security + OAuth2 (UAA) | - | |
||||
| ORM | MyBatis Plus | 3.5.4.1 | |
||||
| 数据库 | MySQL | 8.0.22 | |
||||
| 缓存 | Redis 4 + Caffeine | 2.9.3 | |
||||
| 消息队列 | Kafka + RocketMQ | 2.4.0 / 4.7.0 | |
||||
| 工作流 | Flowable | 6.8.0 | |
||||
| 分布式事务 | Seata (AT模式) | 1.8.0 | |
||||
| 数据同步 | Canal | 1.1.4 | |
||||
| 任务调度 | XXL-Job | 2.2.0 | |
||||
| 链路追踪 | SkyWalking | 8.1.x | |
||||
| 对象存储 | MinIO | 8.4.5 | |
||||
| 接口文档 | Knife4j / Swagger | 4.5.0 | |
||||
|
||||
--- |
||||
|
||||
## 二、项目模块结构 |
||||
|
||||
``` |
||||
apelet_saas |
||||
├── application/ # 业务应用服务 |
||||
│ ├── gateway/ # API 网关 (Spring Cloud Gateway) |
||||
│ ├── upms/ # 用户权限管理系统 (UPMS) |
||||
│ │ ├── upms-api/ # UPMS 对外 API 接口定义 |
||||
│ │ └── upms-service/ # UPMS 服务实现 |
||||
│ └── baseservice/ # 基础业务服务 |
||||
│ └── baseservice-service/ # 基础服务实现 |
||||
│ |
||||
├── application-tenant/ # 租户管理 |
||||
│ ├── tenant-admin/ # 租户运营管理后台 |
||||
│ │ # 管理所有租户、租户菜单/权限/角色、数据源配置 |
||||
│ └── tenant-sync/ # 租户数据同步服务 |
||||
│ # 将 tenant-admin 的配置同步到各租户业务库 |
||||
│ |
||||
├── common/ # 公共模块 |
||||
│ ├── common-generator/ # 代码生成器 |
||||
│ │ # 在线表单开发、反向工程、CGReport 报表 |
||||
│ ├── common-online/ # 在线表单引擎核心 |
||||
│ │ # 动态数据源、在线页面/表单/字典、字段规则 |
||||
│ ├── common-tenant/ # 租户通用模块 |
||||
│ └── common-tenant-online/ # 租户在线表单通用模块 |
||||
│ |
||||
├── framework/ # 框架基础设施 |
||||
│ ├── uaa/ # 统一认证授权中心 (UAA) |
||||
│ │ ├── uaa-admin/ # UAA 管理端 (客户端管理、操作员管理) |
||||
│ │ └── uaa-auth/ # UAA 认证服务 (OAuth2 授权) |
||||
│ ├── admin-monitor/ # Spring Boot Admin 监控 |
||||
│ └── canal-cache-sync/ # Canal 缓存同步 |
||||
│ |
||||
└── zz-resource/ # 资源文件 |
||||
├── db-scripts/ # 数据库初始化脚本 |
||||
└── docker-files/ # Docker Compose 部署文件 |
||||
``` |
||||
|
||||
--- |
||||
|
||||
## 三、数据库架构 |
||||
|
||||
系统划分多个数据库，按职责分离： |
||||
|
||||
| 数据库名 | 用途 | 主要服务 | |
||||
|----------|------|----------| |
||||
| `apelet_admin` | 租户管理系统库 | tenant-admin | |
||||
| `apelet` | 租户业务运营库（UPMS + 在线表单 + 报表） | upms-service, baseservice, online, report | |
||||
| `uaa` | 统一认证授权库 | uaa-admin, uaa-auth | |
||||
|
||||
> **多租户隔离**：每个租户可配置独立的数据源（`xy_sys_tenant_datasource`），租户业务数据存储在自己的数据库中，通过 `tenant-sync` 服务将租户管理端的配置同步到各租户业务库。 |
||||
|
||||
--- |
||||
|
||||
## 四、数据库表总览 |
||||
|
||||
### 4.1 租户管理系统库 (`apelet_admin`) |
||||
|
||||
#### 4.1.1 基础组织架构 (无租户隔离，管理租户平台自身) |
||||
|
||||
| 表名 | 说明 | |
||||
|------|------| |
||||
| `xy_sys_dept` | 部门管理表 | |
||||
| `xy_sys_dept_relation` | 部门关联关系表（闭包表） | |
||||
| `xy_sys_dept_post` | 部门岗位关联表 | |
||||
| `xy_sys_post` | 岗位表 | |
||||
| `xy_sys_user_post` | 用户岗位关联表 | |
||||
| `xy_sys_user` | 系统用户表（含密码） | |
||||
| `xy_sys_user_role` | 用户角色关联表 | |
||||
| `xy_sys_role` | 角色表 | |
||||
| `xy_sys_role_menu` | 角色菜单关联表 | |
||||
| `xy_sys_menu` | 菜单表 | |
||||
|
||||
#### 4.1.2 权限管理 |
||||
|
||||
| 表名 | 说明 | |
||||
|------|------| |
||||
| `xy_sys_perm_code` | 权限字表（权限标识，含父子层级） | |
||||
| `xy_sys_menu_perm_code` | 菜单与权限字关联表 | |
||||
| `xy_sys_perm_module` | 权限资源模块表 | |
||||
| `xy_sys_perm` | 权限资源表（URL级别） | |
||||
| `xy_sys_perm_code_perm` | 权限字与权限资源关联表 | |
||||
| `xy_sys_perm_whitelist` | 权限白名单表（认证用户即可访问的URL） | |
||||
| `xy_sys_data_perm` | 数据权限表 | |
||||
| `xy_sys_data_perm_user` | 数据权限用户关联表 | |
||||
| `xy_sys_data_perm_dept` | 数据权限部门关联表 | |
||||
| `xy_sys_data_perm_menu` | 数据权限菜单关联表 | |
||||
|
||||
#### 4.1.3 租户管理 |
||||
|
||||
| 表名 | 说明 | |
||||
|------|------| |
||||
| `xy_sys_tenant` | 租户管理表 | |
||||
| `xy_sys_tenant_ext` | 租户扩展表（关联在线表单页面） | |
||||
| `xy_sys_tenant_datasource` | 租户数据源配置表 | |
||||
| `xy_sys_tenant_role` | 租户角色表 | |
||||
| `xy_sys_tenant_role_tenant` | 租户角色与租户关联表 | |
||||
| `xy_sys_tenant_role_menu` | 租户角色与租户菜单关联表 | |
||||
| `xy_sys_tenant_role_online_page` | 租户角色与在线表单页面关联表 | |
||||
| `xy_sys_tenant_role_report_ds` | 租户角色与报表数据集关联表 | |
||||
|
||||
#### 4.1.4 租户权限模板（同步到租户库的模板） |
||||
|
||||
| 表名 | 说明 | |
||||
|------|------| |
||||
| `xy_sys_tenant_menu` | 租户菜单模板表 | |
||||
| `xy_sys_tenant_menu_perm_code` | 租户菜单与权限字关联表 | |
||||
| `xy_sys_tenant_perm_code` | 租户权限字模板表 | |
||||
| `xy_sys_tenant_perm_code_perm` | 租户权限字与权限资源关联表 | |
||||
| `xy_sys_tenant_perm` | 租户权限资源模板表 | |
||||
| `xy_sys_tenant_perm_module` | 租户权限模块模板表 | |
||||
|
||||
#### 4.1.5 消息与同步 |
||||
|
||||
| 表名 | 说明 | |
||||
|------|------| |
||||
| `zz_producer_transaction_msg` | 事务型消息生产者发送流水表 | |
||||
| `zz_data_sync_producer_trans` | 数据同步生产者消息流水表 | |
||||
| `zz_data_sync_producer_mark` | 数据同步生产者高水标记表 | |
||||
|
||||
--- |
||||
|
||||
### 4.2 租户业务运营库 (`apelet`) |
||||
|
||||
#### 4.2.1 UPMS 业务库（含 tenant_id 隔离） |
||||
|
||||
| 表名 | 说明 | |
||||
|------|------| |
||||
| `xy_sys_tenant` | 租户表（业务库副本） | |
||||
| `xy_sys_dept` | 部门管理表（含 tenant_id） | |
||||
| `xy_sys_dept_relation` | 部门关联关系表 | |
||||
| `xy_sys_dept_post` | 部门岗位关联表 | |
||||
| `xy_sys_post` | 岗位表（含 tenant_id） | |
||||
| `xy_sys_user_post` | 用户岗位关联表 | |
||||
| `xy_sys_user` | 用户表（含 tenant_id，**无密码字段**） | |
||||
| `xy_sys_user_role` | 用户角色关联表 | |
||||
| `xy_sys_role` | 角色表（含 tenant_id） | |
||||
| `xy_sys_role_menu` | 角色菜单关联表 | |
||||
| `xy_sys_menu` | 菜单表（含 tenant_id, tenant_available, tenant_custom） | |
||||
| `xy_sys_perm_code` | 权限字表 | |
||||
| `xy_sys_menu_perm_code` | 菜单与权限字关联表 | |
||||
| `xy_sys_perm_module` | 权限资源模块表 | |
||||
| `xy_sys_perm` | 权限资源表 | |
||||
| `xy_sys_perm_code_perm` | 权限字与权限资源关联表 | |
||||
| `xy_sys_perm_whitelist` | 权限白名单表 | |
||||
| `xy_sys_data_perm` | 数据权限表（含 tenant_id） | |
||||
| `xy_sys_data_perm_user` | 数据权限用户关联表 | |
||||
| `xy_sys_data_perm_dept` | 数据权限部门关联表 | |
||||
| `xy_sys_data_perm_menu` | 数据权限菜单关联表 | |
||||
|
||||
> **注意**：UPMS 业务库与租户管理库表结构高度相似，但关键区别在于： |
||||
> - 业务库的表含 `tenant_id` 字段实现**租户数据隔离** |
||||
> - 业务库 `xy_sys_user` **不含密码字段**（密码由 UAA 统一管理） |
||||
> - 业务库 `xy_sys_menu` 含 `tenant_available`（租户可用标记）和 `tenant_custom`（租户自定义标记） |
||||
|
||||
#### 4.2.2 消息与同步 |
||||
|
||||
| 表名 | 说明 | |
||||
|------|------| |
||||
| `zz_producer_transaction_msg` | 事务型消息生产者流水表 | |
||||
| `zz_data_sync_consumer_trans` | 数据同步消费者消息流水表 | |
||||
| `zz_data_sync_producer_trans` | 数据同步生产者消息流水表 | |
||||
| `zz_data_sync_producer_mark` | 数据同步生产者高水标记表 | |
||||
|
||||
--- |
||||
|
||||
### 4.3 在线表单引擎 (`zz_online_*`) |
||||
|
||||
> **核心概念**：在线表单引擎允许用户通过可视化界面动态创建数据表、表单页面、数据源，无需编写代码。 |
||||
|
||||
| 表名 | 说明 | |
||||
|------|------| |
||||
| `zz_online_dblink` | 数据库链接配置表（支持多数据库） | |
||||
| `zz_online_table` | 在线数据表定义（映射到物理表） | |
||||
| `zz_online_column` | 在线数据表字段定义 | |
||||
| `zz_online_virtual_column` | 虚拟字段表（聚合字段，如 SUM/COUNT） | |
||||
| `zz_online_datasource` | 数据源定义（关联主表，用于表单和页面的数据存取） | |
||||
| `zz_online_datasource_relation` | 数据源关联定义（一对一/一对多/多对多） | |
||||
| `zz_online_datasource_table` | 数据源与数据表关联中间表 | |
||||
| `zz_online_page` | 在线页面表（列表页/表单页/审批页等） | |
||||
| `zz_online_page_datasource` | 页面与数据源关联中间表 | |
||||
| `zz_online_form` | 在线表单表（含 widget_json 组件描述） | |
||||
| `zz_online_form_datasource` | 表单与数据源关联中间表 | |
||||
| `zz_online_dict` | 在线字典表（支持表字典/URL字典/全局字典） | |
||||
| `zz_online_rule` | 字段验证规则表（整数/数字/邮箱/手机/范围等） | |
||||
| `zz_online_column_rule` | 字段与规则关联中间表 | |
||||
|
||||
--- |
||||
|
||||
### 4.4 代码生成器 (`onl_*`) |
||||
|
||||
| 表名 | 说明 | |
||||
|------|------| |
||||
| `onl_form_head` | 在线表单开发主表（表定义头） | |
||||
| `onl_form_field` | 表单开发字段属性表 | |
||||
| `onl_form_check` | 表单字段校验规则表 | |
||||
| `onl_form_find` | 表单查询条件配置表 | |
||||
| `onl_form_index` | 表单索引配置表 | |
||||
| `onl_form_key` | 表单主键/外键配置表 | |
||||
| `onl_form_page` | 表单页面配置表 | |
||||
| `onl_cgreport_head` | CGReport 报表头表 | |
||||
| `onl_cgreport_item` | CGReport 报表项表 | |
||||
| `onl_cgreport_param` | CGReport 报表参数表 | |
||||
| `reverse_writing_business` | 反向写入业务配置表 | |
||||
| `reverse_writing_formula` | 反向写入公式配置表 | |
||||
| `reverse_writing_rules` | 反向写入规则表 | |
||||
|
||||
--- |
||||
|
||||
### 4.5 报表引擎 (`zz_report_*`) |
||||
|
||||
| 表名 | 说明 | |
||||
|------|------| |
||||
| `zz_report_tenant_dataset` | 租户数据集关联表（多租户） | |
||||
| `zz_report_dataset` | 数据集定义表 | |
||||
| `zz_report_dataset_column` | 数据集字段表 | |
||||
| `zz_report_dataset_group` | 数据集分组表（树形） | |
||||
| `zz_report_dataset_relation` | 数据集关联表（一对一/一对多） | |
||||
| `zz_report_dblink` | 报表数据库链接表 | |
||||
| `zz_report_dict` | 报表字典表 | |
||||
| `zz_report_page` | 统计报表页面表（含 page_json 配置） | |
||||
| `zz_report_page_group` | 统计页面分组表（树形） | |
||||
| `zz_report_print` | 打印模板表 | |
||||
| `zz_report_print_group` | 打印模板分组表（树形） | |
||||
| `zz_report_visualization` | 大屏可视化数据表 | |
||||
| `zz_report_visualization_asset` | 大屏可视化素材表 | |
||||
|
||||
--- |
||||
|
||||
### 4.6 UAA 认证授权库 (`uaa`) |
||||
|
||||
| 表名 | 说明 | |
||||
|------|------| |
||||
| `xy_auth_client_details` | OAuth2 客户端详情表（client_id/secret/授权方式） | |
||||
| `xy_sys_uaa_user` | UAA 认证用户表（username/password，用于业务用户登录） | |
||||
| `xy_sys_uaa_operator` | UAA 操作员表（管理 UAA 本身的后台用户） | |
||||
|
||||
--- |
||||
|
||||
### 4.7 公共支撑表 |
||||
|
||||
| 表名 | 所属脚本 | 说明 | |
||||
|------|----------|------| |
||||
| `zz_global_dict` | global-dict | 全局字典表（跨租户共享） | |
||||
| `zz_global_dict_item` | global-dict | 全局字典数据项表 | |
||||
| `zz_sys_operation_log` | operation-log | 系统操作日志表（所有微服务共享） | |
||||
| `zz_mobile_entry` | mobile | 移动端入口表 | |
||||
| `zz_mobile_entry_data_perm` | mobile | 移动端入口数据权限关联表 | |
||||
| `zz_mobile_entry_role` | mobile | 移动端入口角色关联表 | |
||||
| `undo_log` | seata | Seata AT模式事务回滚日志表 | |
||||
|
||||
--- |
||||
|
||||
## 五、表关系核心 ER 图 |
||||
|
||||
### 5.1 租户管理端 — 权限体系关系 |
||||
|
||||
``` |
||||
┌──────────────────────────────────────────────────────────────┐ |
||||
│ 权限资源体系 │ |
||||
│ │ |
||||
│ xy_sys_perm_module (权限模块) │ |
||||
│ │ 1:N │ |
||||
│ ▼ │ |
||||
│ xy_sys_perm (权限资源-URL级) │ |
||||
│ │ N:M (xy_sys_perm_code_perm) │ |
||||
│ ▼ │ |
||||
│ xy_sys_perm_code (权限字-树形) ◄── N:M ── xy_sys_menu │ |
||||
│ │ xy_sys_menu_perm_code │ |
||||
│ │ │ |
||||
│ xy_sys_perm_whitelist (白名单URL，认证即可访问) │ |
||||
└──────────────────────────────────────────────────────────────┘ |
||||
|
||||
┌──────────────────────────────────────────────────────────────┐ |
||||
│ 菜单角色体系 │ |
||||
│ │ |
||||
│ xy_sys_menu (菜单-树形) │ |
||||
│ │ N:M (xy_sys_role_menu) │ |
||||
│ ▼ │ |
||||
│ xy_sys_role (角色) │ |
||||
│ │ N:M (xy_sys_user_role) │ |
||||
│ ▼ │ |
||||
│ xy_sys_user (用户) │ |
||||
│ │ N:M (xy_sys_user_post) │ |
||||
│ ▼ │ |
||||
│ xy_sys_post (岗位) ── N:M ── xy_sys_dept (部门-树形) │ |
||||
│ xy_sys_dept_post │ |
||||
│ │ |
||||
│ xy_sys_dept ── 闭包表 ── xy_sys_dept_relation │ |
||||
└──────────────────────────────────────────────────────────────┘ |
||||
|
||||
┌──────────────────────────────────────────────────────────────┐ |
||||
│ 数据权限体系 │ |
||||
│ │ |
||||
│ xy_sys_data_perm (数据权限规则) │ |
||||
│ │ N:M │ N:M │ |
||||
│ ▼ ▼ │ |
||||
│ xy_sys_data_perm_user xy_sys_data_perm_dept │ |
||||
│ (关联用户) (关联部门) │ |
||||
│ │ │ |
||||
│ │ N:M │ |
||||
│ ▼ │ |
||||
│ xy_sys_data_perm_menu (关联菜单) │ |
||||
└──────────────────────────────────────────────────────────────┘ |
||||
``` |
||||
|
||||
### 5.2 租户体系关系 |
||||
|
||||
``` |
||||
┌──────────────────────────────────────────────────────────────┐ |
||||
│ xy_sys_tenant_datasource (租户数据源) │ |
||||
│ │ 1:1 (datasource_type) │ |
||||
│ ▼ │ |
||||
│ xy_sys_tenant (租户) │ |
||||
│ │ 1:1 │ N:M │ |
||||
│ ▼ ▼ │ |
||||
│ xy_sys_tenant_ext xy_sys_tenant_role_tenant │ |
||||
│ (扩展信息) (租户-租户角色) │ |
||||
│ │ │ |
||||
│ ▼ │ |
||||
│ xy_sys_tenant_role (租户角色) │ |
||||
│ │ │ │ │ |
||||
│ ┌─────────┘ │ └─────────┐ │ |
||||
│ ▼ ▼ ▼ │ |
||||
│ tenant_role_menu tenant_role_ tenant_role_ │ |
||||
│ (菜单权限) online_page report_ds │ |
||||
│ (在线页面权限) (报表数据集权限) │ |
||||
│ │ |
||||
│ === 以下为租户权限模板表（同步到各租户业务库） === │ |
||||
│ │ |
||||
│ xy_sys_tenant_menu ── xy_sys_tenant_menu_perm_code │ |
||||
│ │ │ │ |
||||
│ ▼ ▼ │ |
||||
│ xy_sys_tenant_perm_code ── xy_sys_tenant_perm_code_perm │ |
||||
│ │ │ |
||||
│ ▼ │ |
||||
│ xy_sys_tenant_perm │ |
||||
│ │ │ |
||||
│ ▼ │ |
||||
│ xy_sys_tenant_perm_module │ |
||||
└──────────────────────────────────────────────────────────────┘ |
||||
``` |
||||
|
||||
### 5.3 在线表单引擎核心关系 |
||||
|
||||
``` |
||||
┌──────────────────────────────────────────────────────────────┐ |
||||
│ zz_online_dblink (数据库链接) │ |
||||
│ │ │ |
||||
│ ├── 1:N ── zz_online_table (数据表定义) │ |
||||
│ │ │ 1:N │ |
||||
│ │ ├── zz_online_column (物理字段) │ |
||||
│ │ │ │ N:M ── zz_online_column_rule │ |
||||
│ │ │ │ │ │ |
||||
│ │ │ │ ▼ │ |
||||
│ │ │ │ zz_online_rule (验证规则) │ |
||||
│ │ │ │ │ |
||||
│ │ │ └── zz_online_dict (字典) │ |
||||
│ │ │ │ |
||||
│ │ └── zz_online_virtual_column (虚拟字段) │ |
||||
│ │ │ |
||||
│ └── 1:N ── zz_online_datasource (数据源) │ |
||||
│ │ 1:N │ |
||||
│ ├── zz_online_datasource_relation │ |
||||
│ │ (关联: 1:1 / 1:N / N:M) │ |
||||
│ │ │ |
||||
│ ├── zz_online_datasource_table │ |
||||
│ │ (数据源包含的数据表) │ |
||||
│ │ │ |
||||
│ └── Page/Form 引用: │ |
||||
│ ├── zz_online_page_datasource │ |
||||
│ │ │ │ |
||||
│ │ ▼ │ |
||||
│ │ zz_online_page (页面) │ |
||||
│ │ │ 1:N │ |
||||
│ │ ▼ │ |
||||
│ │ zz_online_form (表单) │ |
||||
│ │ │ │ |
||||
│ │ └── zz_online_form_datasource│ |
||||
│ │ │ |
||||
│ └── zz_online_dict (字典) │ |
||||
└──────────────────────────────────────────────────────────────┘ |
||||
``` |
||||
|
||||
### 5.4 多租户数据同步流程 |
||||
|
||||
``` |
||||
tenant-admin (管理库 apelet_admin) |
||||
│ |
||||
│ 修改租户配置（菜单/权限/角色） |
||||
│ |
||||
▼ |
||||
zz_data_sync_producer_trans (消息流水表) |
||||
│ |
||||
│ Kafka 消息 |
||||
│ |
||||
▼ |
||||
tenant-sync (同步服务) |
||||
│ |
||||
│ 消费消息，写入租户业务库 |
||||
│ |
||||
▼ |
||||
租户业务库 (apelet 或独立租户库) |
||||
├── xy_sys_menu (tenant_available, tenant_custom) |
||||
├── xy_sys_role |
||||
├── xy_sys_user |
||||
└── ... (其他 UPMS 表) |
||||
``` |
||||
|
||||
### 5.5 UAA 认证流程 |
||||
|
||||
``` |
||||
用户登录请求 |
||||
│ |
||||
▼ |
||||
Gateway (网关) |
||||
│ |
||||
▼ |
||||
uaa-auth (OAuth2 认证服务) |
||||
│ |
||||
├── xy_auth_client_details (验证客户端) |
||||
├── xy_sys_uaa_user (验证用户密码) |
||||
│ |
||||
▼ |
||||
颁发 JWT Token (含用户信息 + 权限) |
||||
│ |
||||
▼ |
||||
Gateway 解析 Token → 转发到业务微服务 |
||||
│ |
||||
▼ |
||||
upms-service (读取用户权限) |
||||
├── xy_sys_user (用户信息) |
||||
├── xy_sys_user_role → xy_sys_role → xy_sys_role_menu → xy_sys_menu |
||||
├── xy_sys_menu_perm_code → xy_sys_perm_code → xy_sys_perm |
||||
└── xy_sys_data_perm → 数据权限规则 |
||||
``` |
||||
|
||||
--- |
||||
|
||||
## 六、服务启动顺序 |
||||
|
||||
1. **基础设施**: Redis → Zookeeper → Kafka → Nacos |
||||
2. **数据同步**: Canal-Server |
||||
3. **租户管理**: tenant-admin → tenant-sync |
||||
4. **认证服务**: uaa-auth |
||||
5. **权限服务**: upms-service |
||||
6. **业务服务**: baseservice 及其他业务微服务 |
||||
7. **网关**: gateway（最后启动，确保能发现所有微服务） |
||||
|
||||
--- |
||||
|
||||
## 七、关键设计说明 |
||||
|
||||
1. **多租户数据隔离**：租户管理端在 `apelet_admin` 库，各租户业务数据可在同一个 `apelet` 库（通过 `tenant_id` 隔离），也可配置独立数据源实现物理隔离。 |
||||
|
||||
2. **权限模型**：采用 **RBAC**（基于角色的访问控制）+ **权限字（PermCode）** 双层模型。菜单关联权限字，权限字再关联 URL 级权限资源。 |
||||
|
||||
3. **数据权限**：支持6种规则类型（全部可见/只看自己/只看本部门/本部门及子部门/多部门及子部门/自定义部门列表）。 |
||||
|
||||
4. **在线表单引擎**：通过 `数据源(Datasource)` → `数据表(Table)` → `字段(Column)` 三层抽象，实现动态表单的 CRUD 操作。支持表关联、虚拟聚合字段、字段验证规则。 |
||||
|
||||
5. **租户配置同步**：通过 `tenant-sync` 服务 + Kafka 消息，将 tenant-admin 端配置的菜单/权限/角色同步到各租户的业务数据库中。 |
||||
|
||||
6. **密码统一管理**：用户密码存储在 UAA 的 `xy_sys_uaa_user` 表，业务库的 `xy_sys_user` 不含密码字段，实现认证与授权的分离。 |
||||
Loading…
Reference in new issue