深色
风格
视觉表达
S 循环切换
经典
稳定的技术默认风格
信号流
突出动态流向
蓝图
工程评审
编辑风格
适合发布与上线说明
动态
演示
导出
导出图表
便携、整洁的输出
E
分享
分享卡片
1200×630 PNG
路径分享卡片
1200×630 PNG
可达范围分享卡片
1200×630 PNG
复制分享卡片
复制 PNG 到剪贴板
复制图表
复制 PNG 到剪贴板
图像
PNG
无损图像
JPEG
紧凑图像
WebP
现代图像格式
矢量与动效
SVG
可编辑矢量图
WebM
6 秒动效
一个真实后端项目:一次请求从网关到数据库(已脱敏)
←
引导视图
探索此系统
沿精选路径逐步查看,而不改变源图表。
节点
下一步
→
▶
播放故事
#
复制此刻
显示全部
一个真实后端项目:一次请求从网关到数据库(已脱敏)
由 Archify 生成的时序图。
POST /api/business/create
请求头带自定义访问令牌
GET token:{accessToken}
GlobalFilter:令牌不是 JWT,直接查 Redis 取用户
用户对象 JSON
查不到即抛 token 失效异常,返回错误码
GET api-permission:{path}
nil(未命中)
Feign 查该 API 的权限列表
仅在缓存未命中时回源
权限列表(并回填 Redis)
按配置中心路由转发
附带用户身份与权限校验结果
事务写入业务数据与流转留痕
commit OK
发起审批(异步)
IM 回调专用 Controller 写回状态,回调必须幂等
200 统一响应体
经网关原路返回
请求与鉴权
权限缓存未命中,回源
业务落库与响应
浏览器 · 宿主 + 子应用 · 时序参与者
浏览器
宿主 + 子应用
API 网关 · Spring Cloud Gateway · 时序参与者
API 网关
Spring Cloud Gateway
Redis · token / 权限缓存 · 时序参与者
Redis
token / 权限缓存
用户权限服务 · Feign 回源目标 · 时序参与者
用户权限服务
Feign 回源目标
业务服务 · 业务处理层 · 时序参与者
业务服务
业务处理层
MySQL · 业务主库 · JPA · 时序参与者
MySQL
业务主库 · JPA
企业 IM · 审批与回调 · 时序参与者
企业 IM
审批与回调
图例
请求
返回
安全
异步追踪
默认消息
就绪
章节 01 / 01
引导章节
图表指南
探索此系统
×
正在检查已编译语义
01
查找任意节点
搜索标签、职责、类型和稳定 ID。
/
02
追踪路径
查看两个语义节点如何按编写方向连接。
R
03
查看完整系统
打开带实时视口和稳定节点的语义雷达。
M
04
比较语义类型
统计角色、显示流量并比较直接编写的连接。
L
05
播放引导故事
浏览已编写的章节和真实关系。
P
06
进入演示模式
让实时图表占满视口,同时不改变导出。
F
E
导出
T
主题
S
风格
0
重置
+
放大
-
缩小
Esc
关闭
查找节点
×
⌕
/
没有匹配的节点
语义护照
已验证来源
编写可达范围
上游
0
下游
0
×
复制链接
关系
路径探测
选择起点节点
查找起点
复制链接
清除
在图表中选择两个语义节点
←
▶
旅程
→
总览
先选择来源,再选择目标;方向很重要。
语义透镜
比较系统角色
×
最多选择两种语义类型。选择一种可显示其真实流量;选择两种只比较直接编写的关系。
选择一种类型以检查其节点和相连关系。
复制链接
清除
语义雷达
正在构建总览
打开雷达
×
点击节点
拖动平移
语义雷达需要更多地图可见空间。
路径
地图
透镜
阅读
100%
鉴权链关键细节
• token 不是 JWT,直接查 Redis 取用户对象
• 登出即失效,代价是强依赖 Redis 可用
• 权限判定三档,不匹配返回 404「未知接口」
不在同步链路里的部分
• 路由由 Nacos 动态下发并热更新
• 采集侧另有 PostgreSQL 存 GIS/点云
• 大文件走 MinIO,Kafka 承担异步消息
技术栈(pom.xml 证据)
• Java 11 + Spring Boot 2.3.12
• Spring Cloud Alibaba 2.2.6 + Gateway
• OpenFeign + JPA + Redis 客户端 + spring-kafka