前端知识地图
本目录以当前
spectra-ui与logicflow-plugin-flowable源码为事实依据。前端文档按“应用基础设施、业务页面、流程建模、开发交付”拆分，AI 速查内容不属于网站同步范围。
项目入口
| 项目 | 目录 | 技术栈 | 说明 |
|---|---|---|---|
| 01-前端管理后台 | spectra-ui/ | Vue 3、TypeScript、Vite 8、Element Plus、Pinia | 登录、权限、系统管理、OA、通知和运维页面 |
| 00-流程设计器 | logicflow-plugin-flowable/ + spectra-ui/src/views/System/Workflow/ | LogicFlow、Flowable、Vue 3 | BPMN 2.0 建模、属性编辑、XML 导入导出和流程部署 |
spectra-ui 文档导航
| 文档 | 主要回答的问题 |
|---|---|
| 01-前端管理后台 | 项目边界、技术栈、目录结构和已有业务能力是什么？ |
| 02-前端命名规范 | 新增页面、组件、API、Store 和类型时如何命名？ |
| 03-前端启动与路由 | 应用如何启动、路由如何注册、菜单和权限如何生效？ |
| 04-前端状态管理 | Pinia Store 分别保存什么状态，哪些内容允许持久化？ |
| 05-前端请求与安全通信 | 请求封装、Token 刷新、CSRF、加解密、缓存和上传如何工作？ |
| 06-前端页面与业务模块 | 页面、路由、API 模块和业务职责如何对应？ |
| 07-前端公共组件与文件能力 | 公共组件、权限指令、通知中心和断点续传如何复用？ |
| 08-前端开发测试与构建 | 如何安装、开发、联调、测试和构建？ |
设计器文档导航
| 文档 | 主要回答的问题 |
|---|---|
| 00-流程设计器 | 插件、Web 宿主和后端工作流服务之间如何分工？ |
| 01-流程建模插件 | 如何安装插件并完成最小集成？ |
| 02-插件架构与初始化 | 插件初始化时注册哪些上下文、元素、面板和事件？ |
| 03-BPMN元素与节点模型 | 当前真正支持哪些节点、边和导入兼容类型？ |
| 04-属性Schema与编辑面板 | 属性如何定义、展示、校验和持久化？ |
| 05-连接规则与交互行为 | 哪些连线会被拦截，哪些完整性校验仍需宿主实现？ |
| 06-BPMN导入导出 | BPMN XML、Flowable 扩展属性和 DI 坐标如何转换？ |
| 07-Spectra宿主集成 | spectra-ui 如何接入 Picker、编辑已有流程并部署？ |
| 08-构建发布与扩展开发 | 如何构建插件、增加节点或扩展属性？ |
跨层数据流
text
用户操作
│
├─ spectra-ui 页面 / 公共组件
│ ├─ Pinia 保存会话、菜单、加密和业务 UI 状态
│ └─ src/plugin/request 统一发送 HTTP / 二进制请求
│
├─ 工作流设计页面
│ ├─ LogicFlow 维护画布模型
│ ├─ logicflow-plugin-flowable 提供 BPMN 元素和 XML 转换
│ └─ WorkflowApi 调用流程定义、任务和部署接口
│
└─ spectra-admin
├─ 返回授权菜单、权限和业务数据
├─ 接收 BPMN XML 并交给 Flowable 部署
└─ 负责真正的安全、事务、持久化和流程运行维护规则
- 新增页面时，同时检查
src/views/、src/plugin/router/modules/、菜单权限和本目录页面矩阵。 - 新增 API 时，只从
src/plugin/request/api.ts或上传适配器进入，不在业务页面直接使用 Axios、fetch或XMLHttpRequest。 - 修改请求字段、权限编码或流程 XML 契约时，联动更新对应的前端文档、后端 API 文档和测试。
- 修改流程节点、属性 Schema 或导入导出逻辑时，优先更新流程设计器对应专题页，再更新本页导航。
- 文档同步时发布项目总览、快速开始、使用指南、前端、后端、开发指南、部署运维、流程设计器、参考文档和参与贡献分区；
AI速查/保持源仓库专用。