# sleveen-admin

**Repository Path**: rainlime/sleveen-admin

## Basic Information

- **Project Name**: sleveen-admin
- **Description**: 一个前端soybean admin加持，后端.net10+mooSQL+hangfire等构建的基础后台管理系统框架
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 1
- **Created**: 2026-01-24
- **Last Updated**: 2026-11-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Net10, mooSQL, vue3, AI, admin

## README

# sleveen-admin

**Element Plus 版 Soybean + .NET 10** 的现代化后台管理系统。面向习惯 Element 生态的团队，提供高颜值壳层与干净可扩展的平台底座；业务、系统模块只保留最核心能力，其余以扩展插件方式生长。

以 Admin.NET 标准版为功能蓝本，采用自研 ORM **mooSQL** 与清晰分层；前端深度改造为 Element Plus + Biz/VC 范式；同仓集成工作流引擎 **sailflow** 与自研 **vue-bpmn**，开箱可搭 OA 与上层业务。

> **壳层**：默认「左栏无界」；首页等为无界 Vue + 门户装配（见 [无界模式](./doc/无界模式/无界模式.md)）  
> **引擎**：流程运行语义走独立仓 **sailflow**（`Start/Run/Reject/…`）  
> **文档**：完善规范文档，便于 AI 驱动上层业务模块搭建

---

## 九大特色

| # | 特色 | 一句话 |
|---|------|--------|
| 1 | [Element Plus × Soybean × .NET 10](#1-element-plus--soybean--net-10) | 习惯 Element 也能拥有高颜值壳 + 现代后端 |
| 2 | [高达 9 种布局模式](#2-高达-9-种布局模式) | 常规后台到沉浸式工作台全覆盖 |
| 3 | [特色【无界】模式](#3-特色无界模式) | 业务模块沉浸式一体化，氛围感拉满 |
| 4 | [内置门户功能](#4-内置门户功能) | 设计器 + 组件 + 千人千面准可用 |
| 5 | [同仓工作流引擎 sailflow](#5-同仓工作流引擎-sailflow) | 各类 OA 开箱可搭 |
| 6 | [源码集成自研 vue-bpmn](#6-源码集成自研-vue-bpmn) | 符合 BPMN，改扩建不受黑盒约束 |
| 7 | [完善规范文档](#7-完善规范文档) | 轻松驱动 AI 搭建上层业务模块 |
| 8 | [多数据库适配无痕](#8-多数据库适配无痕) | 方言切换 + 初始化一键化 |
| 9 | [纯净核心](#9-纯净核心) | 核心精简，扩展以插件生长 |

---

### 1. Element Plus × Soybean × .NET 10

面向习惯 **Element** 生态的团队：前端不是 Naive 原版 Soybean，而是 **Element Plus 深度改造壳**；后端全量 **.NET 10**。

- 前端依赖：`web/package.json` 以 `element-plus` 为主 UI，并保留 `@sa/*`（`materials` / `hooks` / `axios` 等）Soybean 物料体系。
- 壳层改造落点：`web/src/layouts/`、`web/src/theme/settings.ts`、UnoCSS 主题与主题抽屉。
- 后端目标框架：`backend/core/SleveenAdmin.*.csproj` 均为 `net10.0`（Foundation / System / Business / Web.Api）。
- 功能蓝本对齐 Admin.NET（认证、RBAC、租户、基础设施等），ORM 走自研 **mooSQL**（`SleveenAdmin.Foundation` → `MooSqlSetup`）。

一句话：Element 熟练度可直接复用，同时享受 Soybean 级壳体验与 .NET 10 宿主。

---

### 2. 高达 9 种布局模式

布局枚举写死在 `web/src/typings/union-key.d.ts` 的 `ThemeLayoutMode`，主题抽屉与 `base-layout` 全量接线：

| mode | 中文名（`zh-cn.ts`） |
|------|----------------------|
| `vertical` | 左侧菜单模式 |
| `vertical-mix` | 左侧菜单混合模式 |
| `vertical-hybrid-header-first` | 左侧混合-顶部优先 |
| `vertical-card` | **左栏无界**（默认） |
| `horizontal` | 顶部菜单模式 |
| `horizontal-card` | **顶栏无界** |
| `bottom-card` | **底部无界** |
| `top-hybrid-sidebar-first` | 顶部混合-侧边优先 |
| `top-hybrid-header-first` | 顶部混合-顶部优先 |

关键代码：

- 默认布局：`web/src/theme/settings.ts` → `layout.mode: 'vertical-card'`
- 编排入口：`web/src/layouts/base-layout/index.vue`（按 mode 切换侧栏/顶栏/底栏、页签宿主、氛围底）
- 切换 UI：`web/src/layouts/modules/theme-drawer/.../layout-mode.vue` + `layout-mode-card.vue`
- 文案：`web/src/locales/langs/zh-cn.ts` → `theme.layout.layoutMode.*`

从经典左栏后台到无界卡片、底部停靠栏，一套主题配置即可切换，无需另起壳工程。

---

### 3. 特色【无界】模式

「无界」解决传统 Admin「菜单栏 · 页签栏 · 内容栏」三层下巴的割裂感：菜单与内容同一画幅，业务页可沉浸铺满。

两套正交能力：

1. **布局级无界**（`vertical-card` / `horizontal-card` / `bottom-card`）  
   侧栏/顶栏/底栏以圆角卡片或毛玻璃浮岛呈现，内容区整页展示；`base-layout` 挂 `glass-atmosphere` 氛围底。
2. **页面级无界**（`menuType=4`「无界 Vue 组件」）  
   与布局 mode 正交：压缩顶栏与页签、侧栏悬浮、内容 `borderless-content` 去掉 `mainpan` 外边距，背景可全屏穿透。

关键代码：

- `web/src/layouts/base-layout/index.vue`：`isBorderlessPage`（读 `route.meta.menuType`）、`borderless-content`、无界时 `CardTabHost` overlay
- `web/src/components/common/borderless-div.vue`：门户/首页内容穿透容器
- `web/src/views/home/homePage.vue`：首页无界 + 门户装配
- 内置路由示例：`web/src/router/routes/builtin.ts`（`menuType: '4'`）
- 专题文档：[doc/无界模式/无界模式.md](./doc/无界模式/无界模式.md)

业务模块只要把菜单类型设为无界 Vue，即可直接吃到沉浸式一体观感。

---

### 4. 内置门户功能

门户不是演示页，而是可配置工作台：**方案 / 页面 / 组件库 / 可视化设计器**，并已接「个人优先 → 组织/公开兜底」的千人千面解析。

| 层次 | 落点 |
|------|------|
| 运行时引擎 | `web/src/ui/portal/paotal.vue` + `ui/portlet.vue`、`ui/cell/applet.vue`、图表与多播部件 |
| 首页外壳 | `web/src/views/home/homePage.vue`（`BorderlessDiv` + `paotal`） |
| 设计器 | `web/src/widgets/portaldesign/views/designPage` |
| 管理页 | `web/src/widgets/sysext/views/paotalconfig/*`（门户方案、页面、组件库、预览） |
| 后端服务 | `backend/core/SleveenAdmin.Business/src/Portal/`（`Biz_Sys_PortalService`、`SysPortalCommonService`、`PortalDbInitializer`） |

千人千面准可用：`SysPortalCommonService.LoadHomePortal` 优先按当前用户个人门户（`Sp_UserId` + `P_Pulic='2'`），再回落组织/公开方案与页面编码绑定——首页与业务子门户同一套解析链。

门户码表种子（控件类型、布局方式、共享类型、主题等）由 `PortalDbInitializer` 启动时写入，设计器与运行时共用。

---

### 5. 同仓工作流引擎 sailflow

流程引擎不以「外挂黑盒」方式接入：运行语义在独立仓 **sailflow**，本仓以 Host 薄适配 + 前端工作台同仓交付，覆盖待办办理、设计、表单、运维等 OA 面。

| 层次 | 落点 |
|------|------|
| Host 适配 | `backend/saiflow/`（`/api/Wf2Xml/*`、`/api/sail/*`，办理聚合、Assignee 适配） |
| 前端工作台 | `web/src/widgets/sailflow/`（待办/已办/抄送、发起与办理、定义/表单、分类/报表、规则集·AI·知识库·模板库） |
| 引擎库配置 | `Configuration/DBCoonfig.json` 中独立连接 `saiflow`（默认同为 SQLite 文件库） |
| 能力说明 | [doc/sailflow-features.md](./doc/sailflow-features.md)、[doc/sailflow-menu-mount.md](./doc/sailflow-menu-mount.md) |

典型办理闭环页面：`SailTaskTodoPage` / `SailTaskDonePage` / `SailProcessDetailPage`；设计入口：`SailDesignerPage`（bpmn-js）与 `SailDesignerVuePage`（vue-bpmn）。菜单按 Seed / 挂载文档写入后即可开箱使用。

---

### 6. 源码集成自研 vue-bpmn

BPMN 设计器不止依赖 `bpmn-js`：同仓源码集成自研 **vue-bpmn**，符合 BPMN 标准，改扩建不受第三方黑盒约束。

- 源码目录：`web/src/widgets/sailflow/vue-bpmn/`（`core/` + `vue/`）
- Vite / TS 别名：`@vue-bpmn/core`、`@vue-bpmn/vue`（见 `web/vite.config.ts`、`web/tsconfig.json`）
- 宿主页：`SailDesignerVuePage.vue` → `import { BpmnModeler } from '@vue-bpmn/vue'`
- 统一工具栏抽象：`designer/engine.ts`（`kind: 'bpmn-js' | 'vue-bpmn'`）
- 约束与同步说明：`vue-bpmn/README.md`（禁止产品代码依赖 `bpmn-js` / `diagram-js`；sf 扩展 round-trip 脚本可验）

需要改选区、属性面板、XML 进出或 `sf:` 扩展时，直接改本仓库源码即可，不必 fork 上游 npm 包。

---

### 7. 完善规范文档

文档不是附录，而是 **AI / 人共建上层业务的驱动契约**：从 Biz/VC 范式到无界、门户、SQL 安全、流程挂载均有落点。

| 文档 | 用途 |
|------|------|
| [doc/pc/design/biz-module-paradigm.md](./doc/pc/design/biz-module-paradigm.md) | Page / VC / Biz 栈标准结构（含分层图） |
| [doc/pc/design/代码风格规范.md](./doc/pc/design/代码风格规范.md) | 前后端风格与落位 |
| [doc/pc/design/数据库查询.md](./doc/pc/design/数据库查询.md) / [树查询.md](./doc/pc/design/树查询.md) | mooSQL 查询约定 |
| [doc/pc/design/业务子门户工作台实施计划.md](./doc/pc/design/业务子门户工作台实施计划.md) | 业务子门户 + `paotal` 标准路径 |
| [doc/无界模式/无界模式.md](./doc/无界模式/无界模式.md) | 无界壳与穿透约定 |
| [doc/pc/audit/](./doc/pc/audit/) | 审计与 SQL 安全红线 |
| [doc/sailflow-*.md](./doc/sailflow-features.md) | 流程能力、菜单挂载、按钮与表单等 |
| `.cursor/rules/` | Cursor 规则与文档交叉索引，直接约束 AI 改码 |

按范式在 `web/src/widgets/<域>/` 与对应后端 Biz 栈落文件，再挂菜单，即可稳定扩展业务模块。

---

### 8. 多数据库适配无痕

数据库切换尽量「改配置、不改业务代码」：ORM 走 **mooSQL** 方言；启动时自动建表 + Seed，开发默认 SQLite 开箱即用。

- 连接配置：`backend/core/SleveenAdmin.Web.Api/Configuration/DBCoonfig.json`  
  - `Master`：`DbType: SQLite` → `App_Data/sleveenadmin.db`  
  - `saiflow`：流程库独立文件，可与主库分置
- 装载与 SQLite 目录保障：`SleveenAdmin.Foundation/src/Data/MooSqlSetup.cs`（相对路径落到 ContentRoot，自动建目录）
- 一键初始化：`Program.cs` 启动时依次  
  `IDbInitializer`（系统表 + 菜单/用户 Seed）→ `PortalDbInitializer` → `EbookDbInitializer`
- 建表：`DbInitializer` 内 `db.useDDL().doInitTable(...)`，按实体类型幂等初始化

切换 SQL Server 等：改 `DbType` / `ConnectString` 即可；Hangfire 随主库方言走 Hangfire.MooSql，业务层继续用 Repository / SQLBuilder，无需为方言分叉业务代码。细则见 [doc/mooSQL-integration.md](./doc/mooSQL-integration.md)。

---

### 9. 纯净核心

平台刻意保持「瘦核心 + 厚扩展」：系统与业务底座只留认证、RBAC、组织、字典、配置、文件、日志等最核心能力；领域功能以 **widgets / 独立后端包** 插入，避免巨石堆叠。

| 层次 | 核心 | 扩展示例 |
|------|------|----------|
| 后端分层 | `Foundation`（基础设施）+ `System`（basisOn / Bootstrap）+ `Web.Api` 宿主 | `Business`（门户、AI…）、`backend/saiflow`、`backend/officeman` |
| 前端壳 | `layouts` / `views` / `ui` 平台壳 | `web/src/widgets/sailflow`、`officeman`、`portaldesign`、`sysext`、`holdOrgPan` |
| System 内切 | `widgets/basisOn`、`Bootstrap`、`configs` | `widgets/plugins` 预留插件位 |

新增业务域的推荐路径：后端独立包或 `Business` 切片 + 前端 `widgets/<域>`（Page/VC/Biz 范式）→ Seed/菜单挂载。核心仓保持干净，扩展可单独演进甚至拆仓。

---

### 平台能力速览

| 模块 | 能力 |
|------|------|
| **认证授权** | JWT + RefreshToken 轮换、图形验证码、按钮级权限 |
| **RBAC** | 用户 / 角色 / 菜单 / 组织，动态路由与菜单 |
| **平台扩展** | 多租户隔离、公告与站内信、SignalR 在线用户、Hangfire 定时任务 |
| **基础设施** | 文件上传、操作/访问日志、服务器监控、Redis 键值管理 |
| **无界壳** | 左栏无界（`vertical-card`）、无界 Vue 页（`menuType=4`）、悬浮侧栏 / 压缩顶栏页签 |
| **门户工作台** | `paotal` 可配置卡片网格；首页 / 业务子门户；与无界组合浑然一体 |
| **AI 助手** | Microsoft Agents Framework (MAF) 流式对话，SSE 接口 |
| **Sailflow 流程** | BPMN 设计器（`sf:` 扩展）、动态表单、待办/已办/抄送、规则集·AI 活动·知识库 |
| **部署** | YARP 开发代理、生产 SPA 静态托管、Docker 单端口部署 |

---

## 技术栈

### 后端

- **.NET 10**（`net10.0`）
- **mooSQL.Ext** — ORM，开发默认 SQLite，可切换 SQL Server 等
- **DI 源生成** — `[Scoped]` / `[Singleton]` / `[Transient]` + 编译期 `Add*Services()`
- **JWT Bearer** + 自定义 `PermissionAuthorizationHandler`
- **Hangfire** — 定时任务，存储走 **Hangfire.MooSql**（复用主库 + 表前缀 `hf_`；默认启用，SQLite / MSSQL 等均可）
- **StackExchange.Redis** — 缓存与监控
- **YARP** — 内嵌反向代理，单端口联调/部署
- **Mapster** — 对象映射
- **sailflow** — 独立解决方案引擎；本仓 `backend/saiflow` 为 Host 薄适配（`/api/Wf2Xml`、`/api/sail/`*）

### 前端

- **Vue 3** + **Vite 7** + **TypeScript**
- **Element Plus** + **UnoCSS**（Soybean Admin Element 壳，深度改造；**9 种布局**含无界系列）
- **门户引擎** — `@/ui/portal/paotal.vue` + Portlet VC + 门户设计器；首页 `homePage` + `BorderlessDiv`
- **vue-bpmn** — 源码集成自研 BPMN Vue 组件（`widgets/sailflow/vue-bpmn`），改扩建不受约束
- **vue-element-plus-x** — AI 助手流式 UI
- **SignalR** — 在线用户实时连接
- **widgets/sailflow** — 流程工作台（待办办理壳 + 设计器，API 为 Sail 形状）

---

## 架构

```
sleveen-admin/
├── backend/                         # 后端（sln + 源码 + 测试）
│   ├── sleveenAdmin.sln
│   ├── core/
│   │   ├── SleveenAdmin.Foundation/ # ApiResult、分页、mooSQL、安全
│   │   ├── SleveenAdmin.System/     # Auth / User / Role / Menu / Org / Dict …
│   │   ├── SleveenAdmin.Business/   # AI 等业务扩展
│   │   └── SleveenAdmin.Web.Api/    # 宿主：Program、JWT、中间件
│   ├── saiflow/                     # Sailflow Host：Wf2Xml、办理聚合、Assignee 适配
│   └── tests/SleveenAdmin.Tests/
├── web/                             # 前端（Element Plus / Soybean 改造）
│   └── src/
│       ├── layouts/                 # base-layout：左栏无界 / 无界页编排
│       ├── ui/portal/               # paotal 门户引擎
│       ├── views/home/              # 首页无界 + 门户外壳
│       └── widgets/                 # 业务域（含 sailflow、officeman …）
├── doc/
│   ├── 无界模式/无界模式.md         # 左栏无界 / 无界 Vue / 门户 / 背景穿透
│   ├── pc/design/                   # 前端设计规范与实施计划
│   ├── pc/audit/                    # 审计要求
│   ├── sailflow-*.md                # 流程接入与能力说明
│   └── archive/                     # R1–R11 等归档
├── PLAN.md                          # 现行架构与路线图
└── IMPLEMENTATION.md                # 指向 R1–R11 归档
```

**依赖方向**：`Business → Foundation`，`System → Foundation`，`Web.Api → System + Business + Foundation + Saiflow`；引擎在外部仓 **sailflow**。细则见 [PLAN.md](./PLAN.md)。

**设计原则**

- **纯净核心**：系统 / 业务仅保留最核心能力，其余以扩展插件（widgets / 插件包）生长
- 业务 Service 用具体类，禁止 Java 式 `IUserService` / `UserServiceImpl` 堆叠
- 域内 `DBLayer → Service → Controller` 纵向切片；配置拆 `Configuration/*.json`
- 前端为 Soybean **深度改造副本**（Element Plus + Biz/VC 范式），非上游 Naive 原样
- 主键 **Guid v7**，列名带表前缀；流程身份键对齐 **`SysUser.Account`**
- 壳层优先「无界」观感：菜单与内容同一画幅，避免多余实色嵌套壳
- 多库无痕：开发默认 SQLite 一键 Seed；切换方言即可面对 SQL Server 等

---

## 功能清单

以下为种子菜单 / 内置页面能力（随 Seed 幂等写入，可在「菜单管理」调整）。隐藏路由（设计器、详情等）不列入侧栏展示项。

### 首页与壳

| 功能 | 说明 |
|------|------|
| **首页** | 无界 Vue + 门户装配（`homePage` → `paotal`），氛围底铺满 |
| **左栏无界布局** | 默认主题 `vertical-card`：圆角卡片侧栏、内容整页 |
| **无界页面形态** | 菜单类型 `menuType=4`：悬浮侧栏、压缩顶栏/页签、内容背景可全屏 |

### 系统管理

| 功能 | 说明 |
|------|------|
| 用户管理 | 账号与资料 |
| 菜单管理 | 路由 / 组件 / 权限标识 / 菜单类型（含无界 Vue） |
| 组织管理 | 组织树 |
| 字典管理 | 数据字典 |
| 配置管理 | 系统配置 |
| 权限配置 | AuthBag 权限包（查看 / 编辑） |

### 平台扩展

| 功能 | 说明 |
|------|------|
| 租户管理 | 多租户 |
| 通知管理 / 我的通知 | 公告与站内信 |
| 在线用户 | SignalR 在线列表 |
| 定时任务 | Hangfire 控制台入口（默认启用；iframe → `/hangfire`） |

### 基础设施

| 功能 | 说明 |
|------|------|
| 文件管理 | 上传与文件元数据 |
| 操作日志 / 访问日志 | 审计日志 |
| 服务器监控 | 主机指标 |
| Redis 管理 | 键值浏览 |

### 门户管理

| 功能 | 说明 |
|------|------|
| 门户配置 | 门户方案 |
| 页面管理 | 门户页 |
| 组件库 | Portlet / 小程序控件 |
| 门户设计 | 可视化设计器 |

### AI

| 功能 | 说明 |
|------|------|
| AI 助手 | MAF 流式对话（SSE） |

### 流程引擎（Sailflow）

| 分组 | 功能 |
|------|------|
| **办理** | 我的待办、我的已办、抄送我的、发起流程、我的流程 |
| **管理** | 任务管理、流程实例管理、流程定义、流程表单 |
| **特色** | 规则集、AI 模型、知识库、回调死信、流程模板库、请假样例 |
| **运维** | 流程分类、流程报表 |
| **设计入口** | 流程设计器 / 表单设计器 / 流程详情 / 流程编辑（侧栏常隐藏，从列表跳入） |

挂载字段与路径见 [doc/sailflow-menu-mount.md](./doc/sailflow-menu-mount.md)。

### 创作工作台（officeman 示例域）

| 功能 | 说明 |
|------|------|
| 素材库 / 选题池 / 笔记 / 分类设置 | 电子书创作域 Biz 示例，可作业务子门户扩展参照 |

### 平台横切能力（非菜单）

| 能力 | 说明 |
|------|------|
| 认证授权 | JWT + RefreshToken、图形验证码、按钮级权限 |
| 动态路由 | 登录菜单树驱动前端路由 |
| 门户引擎 | `paotal` 可配置卡片网格与个性化布局 |
| 单端口部署 | YARP 开发代理 / 生产 SPA 静态托管 / Docker |

---

## 快速开始

### 环境要求

- [.NET 10 SDK](https://dotnet.microsoft.com/download)
- [Node.js](https://nodejs.org/) 20+ 与 [pnpm](https://pnpm.io/)
- （可选）Redis，用于监控与键值管理
- （可选）SQL Server / MySQL / PostgreSQL — 切换主库方言时使用
- 同级可引用的 **sailflow**、**hangfire.moo-sql**、**moo-sqlm** 仓（Web.Api / Foundation 已 ProjectReference）

### 1. 数据库（默认 SQLite，开箱即用）

默认配置已指向文件库 `App_Data/sleveenadmin.db`（相对 Web.Api 内容根）。`dotnet run` 时会自动创建目录、建表并写入 Seed，无需安装外部数据库。

默认超级管理员：

| 账号 | 密码 |
|------|------|
| `admin` | `123456` |

默认连接配置：`Configuration/DBCoonfig.json`（节点 `DBCoonfig`）。Hangfire 默认启用，经 **Hangfire.MooSql** 复用主库（表前缀见 `Configuration/Hangfire.json` 的 `TablesPrefix`，默认 `hf_`）。如需改用 SQL Server，可覆盖主库分片：

```json
{
  "DBCoonfig": {
    "Connections": [
      {
        "Position": 0,
        "Name": "Master",
        "DbType": "MSSQL",
        "ConnectString": "Enlist=false;Data Source=localhost;Database=sleveenadmin;User Id=...;Password=...;Encrypt=True;TrustServerCertificate=True;",
        "Version": "13.0"
      }
    ]
  },
  "Hangfire": {
    "Enabled": true,
    "TablesPrefix": "hf_"
  }
}
```

关闭定时任务：设 `Hangfire:Enabled=false`。

### 2. 启动后端

```bash
cd backend/core/SleveenAdmin.Web.Api
dotnet run
```

- **SleveenAdmin.Web.Api** profile：仅 API + Swagger → `http://localhost:5000/swagger`
- **SleveenAdmin.Unified** profile：单端口联调，非 API 请求代理到 Vite 前端

### 3. 启动前端（独立开发）

```bash
cd web
pnpm install
pnpm dev
```

前端默认运行于 `http://localhost:9527`，API 代理到 `http://localhost:5000`。

流程菜单需在「系统管理 → 菜单管理」按 [doc/sailflow-menu-mount.md](./doc/sailflow-menu-mount.md) 挂载。无界页在菜单中选择类型「无界 Vue 组件」（`menuType=4`），说明见 [无界模式](./doc/无界模式/无界模式.md)。

### 4. 生产 / Docker

```bash
# 构建前端 + 单端口运行
cd web && pnpm build
cd ../backend/core/SleveenAdmin.Web.Api && dotnet run --environment Production

# 或使用 Docker（映射 8080）
cd ../..
docker compose up --build
```

### 5. 运行测试

```bash
dotnet test
```

---

## API 约定

- 统一响应：`{ "code": "0000", "msg": "...", "data": ... }`（平台 API）
- Sailflow Host：`ResponseResult` / `Entity`（`/api/Wf2Xml/*`、`/api/sail/*`）
- 认证头：`Authorization: Bearer <token>`，可辅 `X-Token` / `X-Refresh-Token`
- 动态路由：`GET /api/auth/user-info`、`GET /api/sysMenu/login-menu-tree`

---

## 路线图

总原则：在 AI 辅助开发场景下，**业务分层清晰、堆叠不崩**；壳层继续向「无界一体」演进。细则见 [PLAN.md](./PLAN.md) §7。

### 已落地（底座与壳）

- [x] R1–R11 平台底座（RBAC、基础设施、YARP、AuthForm、MAF AI 骨架等）— [归档](./doc/archive/IMPLEMENTATION-R1-R11.md)
- [x] Sailflow 流程工作台挂载（设计 / 表单 / 待办办理等，见 `doc/sailflow-*.md`）
- [x] **左栏无界**默认布局（`vertical-card`）+ App 根布局 class
- [x] **无界 Vue**（`menuType=4`）：悬浮侧栏、压缩顶栏/页签、mainpan 穿透
- [x] **首页门户**：`homePage` 外层氛围底 + `BorderlessDiv` + `paotal` 穿透
- [x] 无界专题文档：[doc/无界模式/无界模式.md](./doc/无界模式/无界模式.md)

### 进行中 / 下一阶段

| 轨道 | 要点 |
|------|------|
| **无界与门户** | 业务子门户 `Biz_*Portal` 按规范落地；更多菜单切无界页；氛围一体感与卡片玻璃打磨；门户切换缓存 |
| **AI** | 会话持久化与历史；知识库/流程活动联动；Agent 工具边界；模型/指令可配置 |
| **审批工作流** | 办理闭环 UAT；选人/下一跳/按钮；待办人与宿主主数据对齐；设计器与表单缺口收口 |
| **开发文档** | widgets 新增 / 挂菜单 / Configuration 分片短手册；Cursor 规则与范式对齐；文档交叉索引 |
| **平台稳定性** | 数据权限与租户边界；Seed/菜单/权限标识一致；日志审计与运维体验（并行） |

---

## 相关文档

### 壳层与前端设计

| 文档 | 说明 |
|------|------|
| [doc/无界模式/无界模式.md](./doc/无界模式/无界模式.md) | **无界理念**、左栏无界 / 无界 Vue / 门户模式、背景穿透与选择器 |
| [doc/pc/design/业务子门户工作台实施计划.md](./doc/pc/design/业务子门户工作台实施计划.md) | 业务子门户外壳 + `paotal` 标准路径 |
| [doc/pc/design/代码风格规范.md](./doc/pc/design/代码风格规范.md) | 前后端代码风格与落位 |
| [doc/pc/design/biz-module-paradigm.md](./doc/pc/design/biz-module-paradigm.md) | 业务模块 Page / VC / Biz 范式（design 目录） |
| [doc/biz-module-paradigm.md](./doc/biz-module-paradigm.md) | 业务模块范式（仓根摘要/副本） |
| [doc/pc/design/选择器设计规范.md](./doc/pc/design/选择器设计规范.md) | 选择器设计 |
| [doc/pc/design/树查询.md](./doc/pc/design/树查询.md) / [数据库查询.md](./doc/pc/design/数据库查询.md) | 查询约定 |
| [doc/pc/audit/审计要求.md](./doc/pc/audit/审计要求.md) | 审计总册 |

### 平台与架构

| 文档 | 说明 |
|------|------|
| [PLAN.md](./PLAN.md) | 架构约束、Soybean 改造、分层/配置、未来路线图 |
| [doc/archive/IMPLEMENTATION-R1-R11.md](./doc/archive/IMPLEMENTATION-R1-R11.md) | R1–R11 实施归档 |
| [doc/mooSQL-integration.md](./doc/mooSQL-integration.md) | mooSQL 在本仓的用法 |

### Sailflow 流程

| 文档 | 说明 |
|------|------|
| [doc/sailflow-features.md](./doc/sailflow-features.md) | **Sailflow 现行能力**（产品/接入/开发） |
| [doc/sailflow-host-capability-pack.md](./doc/sailflow-host-capability-pack.md) | Host 能力包：`UseDebugConsoleHook` / Leave / Portal 等 |
| [doc/sailflow-menu-mount.md](./doc/sailflow-menu-mount.md) | 流程菜单挂载字段表 |
| [doc/sailflow-nflowable-feature-replication.md](./doc/sailflow-nflowable-feature-replication.md) | 流程产品面复刻规划与进度 |
| [doc/sailflow-assignee-candidate-design.md](./doc/sailflow-assignee-candidate-design.md) | 待办人 / 候选人配置 |
| [doc/sailflow-buttons-capability.md](./doc/sailflow-buttons-capability.md) | 办理按钮 `sf:ButtonsSetting` |
| [doc/sailflow-designer-sidebar-gap.md](./doc/sailflow-designer-sidebar-gap.md) | 设计器侧栏 / 齿轮弹窗缺口 |
| [doc/sailflow-portal-todo-push.md](./doc/sailflow-portal-todo-push.md) | 待办推送集成平台（统一日程） |
| [doc/sailflow-form-biz-handler.md](./doc/sailflow-form-biz-handler.md) | 表单业务处理器 |
| [doc/sailflow-field-modes.md](./doc/sailflow-field-modes.md) | 字段模式 |

引擎仓另有《特性说明-引擎能力基线》《特性说明-待办人管道》等，以 **sailflow** 仓库 `doc/sail/` 为准。

---

## 致谢

- 功能蓝本参考 [Admin.NET](https://gitee.com/zuohuaijun/Admin.NET)
- 前端基于 [Soybean Admin](https://github.com/soybeanjs/soybean-admin)
- ORM 来自同仓系 [mooSQL](../../moo-sqlm/mooSQL2024/)
- 流程引擎为独立仓 **sailflow**

---

## License

待定 / 与主仓库保持一致。