release: bump version to 0.62.0
This commit is contained in:
linkong
@@ -22,7 +22,7 @@
|
||||
|
||||
- [App.tsx](/home/ray/dev/linkong/planet/frontend/src/App.tsx)
|
||||
|
||||
当前后台相关路由包括：
|
||||
当前正式后台路由已经由 Admin Next 接管：
|
||||
|
||||
- `/admin`
|
||||
- `/users`
|
||||
@@ -37,15 +37,45 @@
|
||||
- `/collection-management`
|
||||
- `/settings`
|
||||
|
||||
这些路径渲染 [AdminNextRoutes.tsx](/home/ray/dev/linkong/planet/frontend/src/admin-next/AdminNextRoutes.tsx)，页面清单和菜单元信息来自 [manifest.tsx](/home/ray/dev/linkong/planet/frontend/src/admin-next/routes/manifest.tsx)。`/admin-next/*` 仅作为兼容入口存在，会重定向到上面的正式路径，不再作为并行主入口。
|
||||
|
||||
旧 AntD 控制台保留在 `/legacy/admin/*`，用于对照和回退：
|
||||
|
||||
- `/legacy/admin`
|
||||
- `/legacy/admin/datasources`
|
||||
- `/legacy/admin/data`
|
||||
- `/legacy/admin/collection-management`
|
||||
- `/legacy/admin/earth-content`
|
||||
- `/legacy/admin/ai`
|
||||
- `/legacy/admin/logs`
|
||||
- `/legacy/admin/settings`
|
||||
- `/legacy/admin/users`
|
||||
- `/legacy/admin/bgp`
|
||||
- `/legacy/admin/alerts/*`
|
||||
|
||||
旧页面、`AppLayout`、`antd` 和 `@ant-design/icons` 在 legacy 验收期继续保留。不要在新版 parity 验收前删除这些文件或依赖。
|
||||
|
||||
`/earth` 是独立展示页，不属于控制台骨架。
|
||||
|
||||
## 当前页面骨架
|
||||
|
||||
控制台公共壳层在：
|
||||
正式后台公共壳层在：
|
||||
|
||||
- [AdminNextLayout.tsx](/home/ray/dev/linkong/planet/frontend/src/admin-next/components/layout/AdminNextLayout.tsx)
|
||||
|
||||
职责：
|
||||
|
||||
- 左侧导航、分组折叠和移动端抽屉
|
||||
- 当前账号、版本、退出登录和主题切换
|
||||
- 顶部搜索、面包屑和页面快捷入口
|
||||
- 内容区单屏高度闭合
|
||||
- Admin Next 内部滚动、表格、详情面板和移动端详情视图协调
|
||||
|
||||
旧 AntD legacy 壳层仍在：
|
||||
|
||||
- [AppLayout.tsx](/home/ray/dev/linkong/planet/frontend/src/components/AppLayout/AppLayout.tsx)
|
||||
|
||||
职责：
|
||||
legacy 职责：
|
||||
|
||||
- 左侧导航
|
||||
- 折叠与展开
|
||||
@@ -66,7 +96,19 @@
|
||||
</Layout>
|
||||
```
|
||||
|
||||
后续控制台页面应优先适配这套壳层，而不是重新定义全页高度语义。
|
||||
后续正式控制台页面应优先适配 `AdminNextLayout` 和 Admin Next 页面模式，而不是继续往旧 `AppLayout` 增加新能力。只有维护 `/legacy/admin/*` 时才应修改旧壳层。
|
||||
|
||||
## Admin Next 分区加载策略
|
||||
|
||||
多 tab 页面由 [PlainResourcePages.tsx](/home/ray/dev/linkong/planet/frontend/src/admin-next/pages/PlainResourcePages.tsx) 统一承载当前的管理型和信息型工作台。分区加载规则是：
|
||||
|
||||
- 初次进入页面只请求当前 active tab，不预先拉取所有 tab 的接口。
|
||||
- 用户切换 tab 时懒加载该 tab；已经加载过的 tab 保留在本地 `states` 缓存中，切回时直接复用。
|
||||
- 手动刷新、保存、测试、上传、生成教程等明确动作只刷新当前分区，避免把无关分区的接口一起打出去。
|
||||
- 数据源目录的筛选条件变化会清掉内置源分区缓存，并按新筛选重新请求当前分区。
|
||||
- 顶部 summary 只统计“已加载分区”，不把未访问 tab 误报成异常接口。
|
||||
|
||||
这样做是为了降低 Earth、AI、采集管理等多分区页面的冷启动压力，同时保留 tab 数量、状态和用户切换后的缓存体验。需要全量健康巡检时应走后端健康接口或显式刷新流程，不要依赖页面初始化时顺手拉所有业务接口。
|
||||
|
||||
## 当前共享组件
|
||||
|
||||
@@ -74,7 +116,8 @@
|
||||
|
||||
文件：
|
||||
|
||||
- [Scrollbar.tsx](/home/ray/dev/linkong/planet/frontend/src/components/Scrollbar/Scrollbar.tsx)
|
||||
- [Scrollbar.tsx](/home/ray/dev/linkong/planet/frontend/src/components/tactile-ui/Scrollbar.tsx)
|
||||
- [Tactile UI 组件库](/home/ray/dev/linkong/planet/docs/technical/zh/tactile-ui-components.md)
|
||||
|
||||
用途：
|
||||
|
||||
@@ -91,7 +134,7 @@
|
||||
|
||||
文件：
|
||||
|
||||
- [ScrollbarOverlay.tsx](/home/ray/dev/linkong/planet/frontend/src/components/Scrollbar/ScrollbarOverlay.tsx)
|
||||
- [ScrollbarOverlay.tsx](/home/ray/dev/linkong/planet/frontend/src/components/tactile-ui/ScrollbarOverlay.tsx)
|
||||
|
||||
用途：
|
||||
|
||||
@@ -100,25 +143,42 @@
|
||||
|
||||
当前使用场景：
|
||||
|
||||
- 数据源
|
||||
- 采集数据
|
||||
- 用户管理
|
||||
- 设置页
|
||||
- 告警页
|
||||
- BGP 页面
|
||||
- Admin Next 数据源、采集数据、采集管理、日志、告警和 BGP 页面
|
||||
- 旧 AntD legacy 页面通过兼容封装继续使用共享滚动能力
|
||||
|
||||
### 3. `TableScrollRegion`
|
||||
|
||||
文件：
|
||||
|
||||
- [TableScrollRegion.tsx](/home/ray/dev/linkong/planet/frontend/src/components/Scrollbar/TableScrollRegion.tsx)
|
||||
- [TableScrollRegion.tsx](/home/ray/dev/linkong/planet/frontend/src/components/tactile-ui/TableScrollRegion.tsx)
|
||||
|
||||
用途：
|
||||
|
||||
- 为表格滚动区提供统一包裹层
|
||||
- 后续新表格页优先复用，不要重复写“表格区域 + overlay scrollbar”样板
|
||||
|
||||
### 4. `SegmentedControl`
|
||||
### 4. `TactileButton` / `TactileSwitch` / `ControlGroup`
|
||||
|
||||
文件：
|
||||
|
||||
- [Button.tsx](/home/ray/dev/linkong/planet/frontend/src/components/tactile-ui/Button.tsx)
|
||||
- [Switch.tsx](/home/ray/dev/linkong/planet/frontend/src/components/tactile-ui/Switch.tsx)
|
||||
- [ControlGroup.tsx](/home/ray/dev/linkong/planet/frontend/src/components/tactile-ui/ControlGroup.tsx)
|
||||
|
||||
用途：
|
||||
|
||||
- Admin Next 全局工具按钮和详情页工具按钮
|
||||
- icon-only + tooltip 的普通操作
|
||||
- 保存、创建、确认、删除、停止等强意图操作
|
||||
- 与 Docs 主题滑块一致的紧凑开关
|
||||
|
||||
当前约束：
|
||||
|
||||
- 默认按钮是白色触感按钮，通过外部投影表达轻微立体感
|
||||
- 无歧义动作优先图标 + tooltip；保存这类强意图动作可保留文字
|
||||
- 业务页面通过 props 和 CSS variables 调整，不要直接手写按钮核心样式
|
||||
|
||||
### 5. `SegmentedControl`
|
||||
|
||||
文件：
|
||||
|
||||
@@ -146,7 +206,7 @@
|
||||
- 颜色优先通过 CSS 变量覆盖，避免在业务组件里硬编码主题色
|
||||
- 适合少量互斥选项，不适合用作长列表、导航菜单或表单下拉
|
||||
|
||||
### 5. `MarkdownRenderer`
|
||||
### 6. `MarkdownRenderer`
|
||||
|
||||
文件：
|
||||
|
||||
@@ -165,7 +225,7 @@
|
||||
- 文档内部链接应通过 `transformLink` 转成 `/docs/:slug`
|
||||
- 标题锚点由 `getHeadingId` 注入，避免渲染器自己理解路由状态
|
||||
|
||||
### 6. `ConnectionTestInput`
|
||||
### 7. `ConnectionTestInput`
|
||||
|
||||
文件：
|
||||
|
||||
@@ -183,7 +243,7 @@
|
||||
- 禁用的集成能力必须同时置灰输入框和连接测试按钮
|
||||
- 组件只负责输入框与测试入口组合，不保存业务状态；调用方仍负责表单值、loading、disabled 和连接请求
|
||||
|
||||
### 7. `TableActions`
|
||||
### 8. `TableActions`
|
||||
|
||||
文件：
|
||||
|
||||
|
||||
Reference in New Issue
Block a user