喵个咪的博客喵个咪的博客
TX7DO
文章列表
文章分类
文章标签
时间线
TX7DO
文章列表
文章分类
文章标签
时间线
健康养生 2Python编程 5随笔日志 1产品设计 1编程技术 70Go编程 68C++编程 10运维技术 36Flutter编程 12设计模式 1汽车 1架构设计 4游戏开发 14量化开发 6物联网开发 7GoWind风行 109生活杂记 1Rust编程 5
RushWind CMS — 三服务拓扑:core 领域层、双 BFF 薄代理与一份契约的双面输出

Date: 11/20/2026Category: Rust编程Tag: Rust, RushWind, gRPC, 架构设计

本文回答一个问题:一个内容平台为什么要拆成 core-service + 双 BFF 三个进程?BFF 里为什么连一句 SQL 都找不到?同一份 proto 契约又怎么同时长出 REST 和 gRPC 两张脸、喂饱五个前端?

RushWind CMS 是一套 Rust 全栈 Headless 内容平台。它的后端是三个进程:core-service 是唯一的领域层,独占 PostgreSQL 与 Redis,只对内暴露 gRPC;admin-api 与 app-api 是两道 BFF,对浏览器与小程序提供 REST + SSE。分工写成一条铁律(仓库根 AGENTS.md):

RushWind Admin — update_mask 写面:字段级白名单、显式清除与点路径合并

Date: 11/20/2026Category: Rust编程Tag: Rust, RushWind, Protobuf, API设计

本文回答一个问题:前端只改了一个昵称,后端凭什么保证其余几十个字段一个都不会被碰坏?「把某字段清空」和「没传这个字段」又怎么在同一个接口里区分?——拆解 update_mask 从契约字段到 SeaORM 赋值行的整条写面链路。

RushWind Admin 的更新接口是同一个形状:请求体带一个 id 和一个大对象 data。麻烦全在细节里——管理后台的字段动辄几十个,一个"只改昵称"的表单提交,其余字段是原样回传的旧值;只要服务端照单全收,任何一个并发窗口里的旧快照都能把别人刚写进去的值覆盖回去。所以这条写面链路要回答的不是"怎么更新",而是三个更细的动词:写(这个字段变了)、清(这个字段要置空)、不动(请求里根本没有它)。整提交语义只有前两个的混合体,区分不了"清空"和"没传"——这就是 update_mask 存在的理由。这批更新接口的集合,仓库文档称作写面(write face):face 是契约驱动架构的既有词汇——同一份 proto 契约朝不同协议投影出 REST 面、gRPC 面、服务面,写面就是其中承载全部更新写路径的那一张,与查询侧相对。

RushWind Admin — 多租户行级隔离与租户回收站:Viewer 三态、repo_shell! 与全域级联清除

Date: 11/20/2026Category: Rust编程Tag: Rust, RushWind, 多租户, 数据权限

本文回答一个问题:一个列表查询怎么做到「想查出别家租户的行都漏不掉」?租户被删之后数据去哪了、恢复时凭什么不撞名、彻底清除时怎么不留下孤儿行?

多租户系统最怕的不是没有隔离,而是"靠每个开发者记得加租户条件"的隔离——新人一个 find_by_id 没带谓词,别家的数据就顺着接口流出去,而且没有人知道。RushWind Admin 把隔离做成两层结构:HTTP 门负责"这个租户能不能用这个接口",数据层谓词负责"这个查询能不能看见那行数据"。删除则更进一步——delete 不是删除,是停车。本文把这两层和一条回收站链路全部拆开。

RushWind Admin — 用 Rust 写的企业级中后台,开源了

Date: 10/1/2026Category: Rust编程Tag: Rust, RushWind, 中后台, 开源项目

中后台大概是世界上被写得最多、也最不被认真对待的软件品类:几乎每家公司都要再写一遍用户、角色、租户、审计,写完还要为它们的安全性、性能与多前端适配反复买单。更麻烦的是,这块代码谁都不敢动——它不产生差异化价值,却出不起事故。RushWind Admin(中文名:锐风)把这套底座用 Rust 完整做了一遍:152 个 proto 契约文件、构建期生成 291 条路由、六类审计日志、存储层多租户隔离、TOTP 多因素认证、异步任务队列、SSE 实时推送、脚本级插件系统,外加 React / Vue Element / Vue Vben 三套前端共享同一份生成客户端。本文是它的自我介绍;至于"Go 写业务、Rust 扛平台"的混合架构论证,另有一篇硬核文专门展开。

RushWind Admin — 契约驱动:291 条路由零手写的工程化拆解

Date: 10/1/2026Category: Rust编程Tag: Rust, RushWind, Protobuf, 代码生成, 契约测试

大多数后端项目的 API 层是"人肉维护的目录":路由注册、参数解析、错误码映射、文档注释——四份东西描述同一个事实,靠人保证一致,于是永远不完全一致。RushWind Admin 把这层做成了编译产物:Protobuf 是唯一契约,构建期确定性生成路由、错误映射、服务接口与绑定计划——291 条路由、491 条错误状态映射、602 个服务接口(按 RPC 声明数计),零手写;前端 TypeScript 客户端同源于契约,三套前端字节相同。本文拆解这条生成流水线的设计与治理,以及三个真实踩到的暗礁——每一个都值得写成生成器作者的检查清单。