Skip to content

设计理念

这页先解释 xiaoye-components 为什么要收束成“基础层 + 中后台业务增强层”双产品线,而不是继续把所有能力混在同一个包里。

这个项目的目标不是把所有能力都塞进一个入口,而是让基础层保持通用、增强层承接中后台高频闭环,把页面编排和请求链路做顺手、做稳定、做成文档能直接复用的形态。

为什么做这次分层

很多团队在做后台系统时,真正卡住的不是“有没有 Button / Input / Table”,而是下面这些问题:

  • 基础组件能单独工作,但放到同一页里以后,请求、筛选、批量动作、详情、编辑开始打架。
  • 单个组件 API 看得见,但页面级闭环很难快速拼出来。
  • 通用组件和后台专属能力混在一起以后,边界越来越模糊。

这个项目想解决的,就是这些更贴近日常开发的问题。

双产品线各自负责什么

基础层保持中性

xiaoye-components 负责原子组件、通用容器、基础输入、基础数据展示和基础浮层,不再混入过多中后台专属业务语义。

增强层承接页面级闭环

xiaoye-pro-components 负责把 SearchForm / ProTable / RequestForm / CrudPage / DetailPage 这类中后台高频链路做成正式公开 API。

中文优先的示例

文档继续保持中文优先,让团队内部讨论、复制示例和调试页面时不需要额外做术语转换。

双产品线分别适合什么

  • xiaoye-components
    • 通用 Vue 3 页面
    • 管理台和业务台的基础控件层
    • 需要中性基础组件的项目
  • xiaoye-pro-components
    • 后台管理系统
    • SaaS 管理台
    • 中后台业务平台
    • 需要快速交付页面闭环的内部工具项目

当前不打算解决什么

  • 基础层直接承接大量页面容器和工作流能力
  • 低代码设计器或自定义规则 DSL
  • BPMN 工作流引擎或后端 SDK
  • 把权限、审批、请求系统做成强绑定业务框架

当前边界

如果你的项目核心需求是“一个包里同时承接基础层、增强层、工作流和业务引擎”,那么当前这套分层策略并不打算往那个方向走。

文档写作约定

  • 先解释这是基础层还是增强层,再给示例和 API。
  • 优先用真实页面语境描述增强件,而不是只写抽象属性名。
  • 聚焦当前版本已经稳定可用的能力,不提前承诺未落地的引擎能力。

推荐怎么继续读

  1. 如果你想先确认基础层覆盖了哪些能力,继续看 组件总览
  2. 如果你更关心真实后台页面怎么组合,直接看 增强组件总览管理后台闭环示例
  3. 如果你已经准备开始接入项目,回到 快速开始