feat: 实现环境变量预设功能 & 移除稀疏检出

## 后端改动
- 添加 Project.envPresets 字段(JSON 格式)
- 移除 Deployment.env 字段,统一使用 envVars
- 更新部署 DTO,支持 envVars (Record<string, string>)
- pipeline-runner 支持解析并注入 envVars 到环境
- 移除稀疏检出模板和相关环境变量
- 优化代码格式(Biome lint & format)

## 前端改动
- 新增 EnvPresetsEditor 组件(支持单选/多选/输入框类型)
- 项目创建/编辑界面集成环境预设编辑器
- 部署界面基于预设动态生成环境变量表单
- 移除稀疏检出表单项
- 项目详情页添加环境变量预设配置 tab
- 优化部署界面布局(基本参数 & 环境变量分区)

## 文档
- 添加完整文档目录结构(docs/)
- 创建设计文档 design-0005(部署流程重构)
- 添加 API 文档、架构设计文档等

## 数据库
- 执行 prisma db push 同步 schema 变更
This commit is contained in:
2026-01-03 22:59:20 +08:00
parent c40532c757
commit d22fdc9618
71 changed files with 9611 additions and 5849 deletions

View File

@@ -5,46 +5,83 @@ import { projectDirSchema } from '../../libs/path-validator.js';
* 创建项目验证架构
*/
export const createProjectSchema = z.object({
name: z.string({
message: '项目名称必须是字符串',
}).min(2, { message: '项目名称至少2个字符' }).max(50, { message: '项目名称不能超过50个字符' }),
name: z
.string({
message: '项目名称必须是字符串',
})
.min(2, { message: '项目名称至少2个字符' })
.max(50, { message: '项目名称不能超过50个字符' }),
description: z.string({
message: '项目描述必须是字符串',
}).max(200, { message: '项目描述不能超过200个字符' }).optional(),
description: z
.string({
message: '项目描述必须是字符串',
})
.max(200, { message: '项目描述不能超过200个字符' })
.optional(),
repository: z.string({
message: '仓库地址必须是字符串',
}).url({ message: '请输入有效的仓库地址' }).min(1, { message: '仓库地址不能为空' }),
repository: z
.string({
message: '仓库地址必须是字符串',
})
.url({ message: '请输入有效的仓库地址' })
.min(1, { message: '仓库地址不能为空' }),
projectDir: projectDirSchema,
envPresets: z.string().optional(), // JSON 字符串格式
});
/**
* 更新项目验证架构
*/
export const updateProjectSchema = z.object({
name: z.string({
message: '项目名称必须是字符串',
}).min(2, { message: '项目名称至少2个字符' }).max(50, { message: '项目名称不能超过50个字符' }).optional(),
name: z
.string({
message: '项目名称必须是字符串',
})
.min(2, { message: '项目名称至少2个字符' })
.max(50, { message: '项目名称不能超过50个字符' })
.optional(),
description: z.string({
message: '项目描述必须是字符串',
}).max(200, { message: '项目描述不能超过200个字符' }).optional(),
description: z
.string({
message: '项目描述必须是字符串',
})
.max(200, { message: '项目描述不能超过200个字符' })
.optional(),
repository: z.string({
message: '仓库地址必须是字符串',
}).url({ message: '请输入有效的仓库地址' }).min(1, { message: '仓库地址不能为空' }).optional(),
repository: z
.string({
message: '仓库地址必须是字符串',
})
.url({ message: '请输入有效的仓库地址' })
.min(1, { message: '仓库地址不能为空' })
.optional(),
envPresets: z.string().optional(), // JSON 字符串格式
});
/**
* 项目列表查询参数验证架构
*/
export const listProjectQuerySchema = z.object({
page: z.coerce.number().int().min(1, { message: '页码必须大于0' }).optional().default(1),
limit: z.coerce.number().int().min(1, { message: '每页数量必须大于0' }).max(100, { message: '每页数量不能超过100' }).optional().default(10),
name: z.string().optional(),
}).optional();
export const listProjectQuerySchema = z
.object({
page: z.coerce
.number()
.int()
.min(1, { message: '页码必须大于0' })
.optional()
.default(1),
limit: z.coerce
.number()
.int()
.min(1, { message: '每页数量必须大于0' })
.max(100, { message: '每页数量不能超过100' })
.optional()
.default(10),
name: z.string().optional(),
})
.optional();
/**
* 项目ID验证架构

View File

@@ -1,14 +1,14 @@
import type { Context } from 'koa';
import { prisma } from '../../libs/prisma.ts';
import { log } from '../../libs/logger.ts';
import { BusinessError } from '../../middlewares/exception.ts';
import { Controller, Get, Post, Put, Delete } from '../../decorators/route.ts';
import { Controller, Delete, Get, Post, Put } from '../../decorators/route.ts';
import { GitManager } from '../../libs/git-manager.ts';
import { log } from '../../libs/logger.ts';
import { prisma } from '../../libs/prisma.ts';
import { BusinessError } from '../../middlewares/exception.ts';
import {
createProjectSchema,
updateProjectSchema,
listProjectQuerySchema,
projectIdSchema,
updateProjectSchema,
} from './dto.ts';
@Controller('/projects')
@@ -135,6 +135,7 @@ export class ProjectController {
description: validatedData.description || '',
repository: validatedData.repository,
projectDir: validatedData.projectDir,
envPresets: validatedData.envPresets,
createdBy: 'system',
updatedBy: 'system',
valid: 1,
@@ -182,6 +183,9 @@ export class ProjectController {
if (validatedData.repository !== undefined) {
updateData.repository = validatedData.repository;
}
if (validatedData.envPresets !== undefined) {
updateData.envPresets = validatedData.envPresets;
}
const project = await prisma.project.update({
where: { id },