Fumadocs IconMSRU | Docs
使用

底层基建模块支撑

解析全栈 Auth(身份认证)、Database(数据管道)、i18n 及 Stores 等支撑体的高级模式抽象

为了将“无死角高内聚”实施到位,同时减少多应用系统不断翻建的“土石方重复挖掘成本”,除了处在代码视觉展现前哨站的 @msru/ui 外,我们在 packages/ 内部分离并严密封锁了一批提供系统动能及全链路中间件的底层引擎防腐层群落

它们是整个微型架构的发动机矩阵。各个 apps/ 只能发出调用指令索求结果,绝不能越俎代庖去碰触直连底层框架的网线。


🛡️ 身份与安全中心中枢:@msru/auth

此内部包负责全域所有的认证状态下发、签名发行、核销鉴定以及多组织结构域(Tenant)隔离和权限控制层级的屏障网关。

  • 高度封装的安全会话库集成:包内集成了现代最前沿的防脱节全类型安全的(如 BetterAuth 或 NextAuth 的定制实现方案)。业务侧开发者只需呼叫 getSession() 或类似的预包装 Hook,根本无需感知底下是走 JWT 还是传统的 Indexed Cookie Redis 比对。
  • 中间件 (Middleware) 防护网络:在 Next.js 的高维流量劫持卡口 (middleware.ts) 提供即插即用的会话过滤网兜支持。
  • 无缝 OAuth 接驳引擎:包含对各级企业三方厂登录协议栈的打通路由闭环整合。从底层代码结构上限制了恶意伪造与提权越级可能。

🗄️ 分布式数据管道总线:@msru/database

前端全栈化并不意味着随地直接在组件里面写充满注入洞的杂乱 SQL,我们构建了一套针对前沿多模态全功能数据库(如 SurrealDB、PostgreSQL 系)深远且厚重的代理抽象隔离层(DAL)。

  • Type-Safety 强制 Schema 与 Zod 防御机制匹配:包含了利用强类型 typescript 接口与 ORM (如 drizzle 等推导映射体系) 及入库前双引擎校验屏障器。所有读取返回和写入数据的 Shape(外观形状) 在编译运行前必须保持严格推导一致,错一个字母构建立抛错死机。这就断绝了运行时字段 undefined 异常。
  • 连接器控制方案池化(Connection Pooling):集中处理防暴增连接机制。它将有效屏蔽 Serverless 长连接导致的边缘节点溢出(Edge Runtime Limits),同时应对巨大的冷热并发请求做统一挂载等待缓冲。
  • 抽象仓储模式接口命令(Repository Pattern):上游业务端只许导入例如 getUserById 这样的特定业务函数 API 指令端,绝不允许在 apps/ 发生拼接裸查底层命令!
packages/database/src/users.ts
// 一个基础 DAL 层的数据安全隔离例子:
import { db } from "./client/pool";

// 我们暴露一个精确指令级且强入参/返参限制的安全函数供外部应用消费
export async function fetchActiveUserProfiles(status: 'online'|'offline') {
  // 底部发生多复杂的图形聚合检索,上层也毫无牵挂并完全绝缘
  return await db.query(
    "SELECT name, status, created_at FROM user WHERE status = $status", 
    { status }
  );
}

🌍 动态国际化配置源泉引擎:@msru/i18n

这是一套控制全工作区系统大屏适配语言下发及覆盖热切流转的包架构。通过隔离配置字典和下发核心,能够保证项目轻松拓展日、欧、东南亚等全球业务。

  • 集束化的静态字典拆堆库:把动辄上千词条的杂乱无章字符串剥离在包的腹地做精细化、高压缩维护。
  • 路由无感上下文覆盖拦截器:提供对 next-intl (或同级抽象体系) 的超前路由钩子集成垫片,动态依据当前用户的 Cookie 与 Header Accept-Language 极速返回对应端字典。
  • 完美契合服务器流式渲染 (SSR & RSC):语言判定处理与注入全数抢在流输出 HTML 数据碎片前敲锤定音。杜绝了进入页面发生长达零点几秒的丑陋的英文→中文跳变闪烁(FOUC 闪屏),并令 Google 等一切搜索引擎爬虫(SEO)如鱼得水完美捕获区域词汇。

🧠 纯客户端交互状态域:@msru/stores

作为将 React 脏乱庞杂的前台视图表现层与持久态、操作历史剥离出来的救护工具架:

  • 极简全局轻量化引擎下锚:包内主要寄托并收缩包裹了轻量高性能底层流池(通常基于 Zustand 这类非侵入性极简哲学实现方案)与相关状态快照探测器。
  • 多切片防丢失闭环缓存设计(Data Slice):把大型连通网及填单向导会话(如“发票连步骤向导提交流”、“全局超复杂多边筛选状态及暗黑环境偏好”)切割成最小单位的 store shard 集合。彻底规避了向底层深厚几层组件链冗长尴尬且繁杂的 Props Drilling 传统传参污染问题(俗称“面条函数下传”)。实现了哪里的按钮都能随时拔起并极速无损调用全局的任何变量指针集。