湛兮
34 lines
1.6 KiB
Markdown
34 lines
1.6 KiB
Markdown
@RTK.md
|
|
|
|
# DevOps 运维平台前端 Agent 入口
|
|
|
|
## 项目规则
|
|
|
|
- 使用当前 Vue 3 + Vite + TypeScript 结构，不引入无关框架。
|
|
- 页面内容、计划文档和交付说明优先使用中文。
|
|
- UI 风格保持安静、工具型、信息密度合理的运维后台，不做营销页。
|
|
- 只在 `devops-platform-web/**` 内修改前端文件，不修改 `devops-platform-api/**` 和 `devops-platform-docs/**`。
|
|
- 改动可运行入口、目录或重要文件时，同步更新 `README.md`。
|
|
|
|
## 技术约束
|
|
|
|
- UI 组件优先使用 Element Plus。
|
|
- 状态管理使用 Pinia。
|
|
- 路由使用 Vue Router。
|
|
- 请求封装使用 Axios，并集中在 `src/services/**`。
|
|
- BPMN 展示使用 `bpmn-js`，不手写替代渲染器。
|
|
- mock 数据集中在 `src/mocks/**`，后续以后端 OpenAPI/Swagger 替换。
|
|
|
|
## API 与安全边界
|
|
|
|
- 前端不得保存 Jenkins token、Gitea token、通知 webhook、LLM API key/baseURL/model。
|
|
- 前端不得直接调用 Jenkins、Gitea、企微、飞书或模型供应商；统一通过后端 API。
|
|
- API 契约以 `/Users/mac033/Desktop/my-project/devops-platform-docs/devops-platform-implementation-tracker.md` 和后端 OpenAPI 为准。
|
|
|
|
## BPMN 与 Agent 边界
|
|
|
|
- BPMN 组件只展示流程图、节点状态和节点详情，不推进状态机。
|
|
- `step.bpmnNodeId` 必须与 BPMN XML 节点 id 一致。
|
|
- Agent 只能作为全局右侧抽屉工具存在，不作为独立侧边栏路由；能力只允许 DevOps 场景：发布风险摘要、失败诊断、Runbook 问答、发布说明草稿。
|
|
- 禁止在前端新增泛聊天入口。
|