Skip to content

1.7.0 — ID 全链定版 int64 + 三端机制层抽包 + 租户回收站 + 渐进式验证码

Latest

Choose a tag to compare

@tx7do tx7do released this 18 Nov 02:44
· 9 commits to main since this release

1.7.0(2026-11-18)

本版本完成 ID 全链定版 int64、三端机制层抽包发 npm 与 locale 按模块拆分 三件架构级变更,并落地租户回收站、渐进式验证码两项功能与一批三端修复。

变更(含破坏性)

ID 全链定版 int64

全部资源 ID 从 uint32 经 uint64 收敛到有符号 int64——proto/ent/手写代码与上游 pin 同步切换,三端 TS 生成代码重生成 + 前端 ID 字符串化;docs/field_change_guide.md 与 crud 指南/教程/专题文档同步 64 位口径。
升级注意:ent 自动迁移把 ID 列加宽为 bigint(uint32 存量值无损);三端生成代码已随仓提交,采用者无需自行 make ts;二开模块的自有 ID 字段请按新口径对齐。

三端机制层抽包发 npm

基座机制不再随本仓 merge 同步,全部发 npm(go-wind-ui 仓,changesets 自动发版):

  • react 机制层(shell 机制/ListTable/通用 hooks/导出引擎)= @go-wind/admin-react(宿主随本版升到 0.3.1)
  • vue 两端共享 transport/storage/utils/crypto = @go-wind/admin-core
  • element 绑定层(auth 编排/Pinia stores/路由工厂/偏好/i18n)= @go-wind/admin-element
  • vben 基座(preferences/stores/i18n/ui-kit,源码形态包)= @go-wind/admin-vben(宿主随本版升到 0.1.5,中途修复 json-bigint 拖累 JsonViewer)

本端 pnpm update <包> 升级;业务倒逼的框架修改仍直接改本仓各端保留的热区。
升级注意:三端 import 拓扑变化,二开者按 docs/adopt-one-frontend.md §7 的目录所有权契约与 merge runbook 处理升级冲突(lockfile/generated 不手解)。

三端 locale 按模块拆分

共享登记缝消灭——locale 按模块拆文件、react 删除 hooks barrel;core 文案收归宿主全量自持(包内死数据清空,深合并逐键覆盖)。二开升级冲突面收窄为"一模块一文件"。

新增

租户回收站(issue #3)

删租户不再物理删除——delete 停车(软删 + 带旁路的软删拦截器,唯一索引×软删的约束映射一并处理),/tenants/trash 列表 / /tenants/{id}/restore 恢复 / /tenants/{id}/purge 彻底清除三个 RPC;三端同一管理页 active/trash 两态切换。

渐进式验证码(issue #1 建议项)

登录不再常显验证码——同一 ip+用户名的失败计数达到阈值(captchaRequiredThreshold,现值 1)后才强制;验证码 id/value 经 X-Captcha-Id / X-Captcha-Value Header 传递,后端以 CAPTCHA_REQUIRED / CAPTCHA_INVALID reason 驱动三端登录页点亮验证码字段;Redis/验证码服务不可用时 fail-open。

其他

  • 菜单 IconPicker(react 先行,ele/vben 待移植):菜单抽屉可搜索图标选择器 + 列表穿图标展示(依赖 menu meta 双 bug 修复打通)
  • 标签标题全局更新器(react):登录页/错误页此前裸应用名,现按路由 meta 全局更新 document.title
  • 存储键命名空间隔离:三端 localStorage 键隔离(react 包键隔离随 @go-wind/admin-react 0.3.1 生效)——同机多项目部署不再互相污染
  • 响应式两道门禁:<1024 视口顶栏面包屑整体隐藏(vben 本有,react/ele 以同一谓词补齐);<720 视口分栏三端统一堆叠为纵向
  • API 管理页方法列色标(vben):GET 绿 / POST 蓝 / PUT 橙 / DELETE 红(antd 预设色对齐 react 基准)

修复

  • 后端 menu meta 双 bug:UpdateMenu 的 field-mask 遇点路径(meta.icon 等)被拍平拒绝、NULL meta 列合并时被吞——菜单 meta 此前"保存 200 不落库",IconPicker 链路正是被它挡住
  • 九项 UX 问题波(issues #1/#2/#4/#5/#9 前端面):三端登录文案统一、flow-form 查询区、组织树面板重构、左树组织页、权限抽屉选项缓存
  • vue-element:菜单页裸 $t(meta?.title) 遇空 title 打崩 VxeTableBody(对齐 vben 守卫);MenuDrawer prefix 属性穿透根 div 开抽屉必炸;密码眼睛统一 PasswordToggle(EP 2.14 quirk 13 处清齐)
  • vue-vben:out-in+KeepAlive :key=fullPath 致查询变化跳过登录表单挂载(webview 硬化系列);树+表页混合列宽窄视口压扁出黑带;工作台快捷入口 accent 灰块改前景色水洗;devtools null vnode 与存储前缀
  • react:org-unit 表格 scroll-y 钩子 containerRef 未挂载致卡片下方留死区;antd6 TreeSelect 弃用警告以 pnpm patch 迁移 pro-field 旧 props(上游迁移后撤)
  • 契约面:/tenants/trash 逃出 gorilla 路由遮蔽 + stub 补真实错误面;vue 两端 i18n 修复批次

部署注意

  1. 重启后端(ent 自动迁移加宽 ID 列为 bigint;二进制内 openapi.yaml 已含回收站三端点)
  2. 管理页**「接口同步」**:登记 /tenants/trash、/tenants/{id}/restore、/tenants/{id}/purge,否则租户闸门 fail-closed 403
  3. 二开者:三端 import 拓扑已变(机制层抽包 + locale 拆分),升级冲突按 docs/adopt-one-frontend.md §7 的 merge runbook 处理
  4. 门禁基线:三端 typecheck + 后端 build 全绿(2026-11-18 复验)