Self-hosted workflows for coding-agent delivery. Orchestrate CodeBuddy, Codex and Claude Code with scripts and human approval gates. Includes Local workflows for coding assistants.
JavaScript agent-orchestrationagentic-workflowai-agentsai-codingclaude-codecode-reviewcodebuddycodexcoding-agentscursordeveloper-toolshuman-on-the-loopllmmcpmulti-agentsdlcself-hostedsopworkflow-automationworkflow-engine
package httpapi
import (
"agentflow/internal/domain"
"agentflow/internal/repo"
"errors"
"github.com/gin-gonic/gin"
"gorm.io/gorm"
"log"
"net/http"
"strconv"
"strings"
"time"
)
type projectsHandlers struct{ *deps }
func (h *projectsHandlers) projects(c *gin.Context) {
r := c.Request
if r.Method == http.MethodGet {
c.JSON(200, domain.PublicProjects(h.repo.Projects()))
return
}
if r.Method == http.MethodPut || r.Method == http.MethodPost {
var body struct {
domain.Project
TAPDClear bool `json:"tapdClear"`
}
if !decode(c, &body) {
return
}
if body.ID == "" || body.Name == "" {
c.JSON(400, map[string]string{"error": "id and name are required"})
return
}
v := body.Project
existing, exists := h.repo.Project(v.ID)
if v.BusinessDomainID != "" && (!exists || v.BusinessDomainID != existing.BusinessDomainID) {
c.JSON(400, gin.H{"error": "请通过业务域归属接口调整项目归属"})
return
}
if exists {
v.BusinessDomainID = existing.BusinessDomainID
}
if exists && existing.ArchivedAt != nil {
c.JSON(http.StatusConflict, gin.H{"error": "项目「" + existing.Name + "」已删除,标识 " + existing.ID + " 仍被占用;请换一个标识,或先恢复该项目"})
return
}
v.ArchivedAt, v.ArchivedBy = nil, 0
if authRequired() {
user, ok := h.requestUser(r, true)
if !ok {
c.JSON(401, gin.H{"error": "请先登录"})
return
}
if !h.isPlatformAdmin(r) {
if exists && existing.OwnerID != user.ID {
c.JSON(403, gin.H{"error": "只有项目 Owner 或平台管理员可以修改项目设置"})
return
}
if !exists {
if v.OwnerID == 0 {
v.OwnerID = user.ID
}
if v.OwnerID != user.ID {
c.JSON(403, gin.H{"error": "新项目 Owner 必须为当前用户"})
return
}
}
}
}
isNew := true
if existing, ok := h.repo.Project(v.ID); ok {
isNew = false
if v.OwnerID == 0 {
v.OwnerID = existing.OwnerID
}
if v.Members == nil {
v.Members = existing.Members
}
if v.SOPBindings == nil {
v.SOPBindings = existing.SOPBindings
}
if v.SOPPlaybooks == nil {
v.SOPPlaybooks = existing.SOPPlaybooks
}
}
if err := h.applyProjectPlaybook(&v); err != nil {
c.JSON(400, map[string]string{"error": err.Error()})
return
}
// A brand-new project starts with the built-in LoopForge backend
// delivery SOP when none was picked, so synced and newly created
// requirements run out of the box (see repo.bindDefaultWorkflow).
if isNew && strings.TrimSpace(v.WorkflowID) == "" {
v.WorkflowID = repo.GenericBackendDeliveryWorkflowID
}
if v.OwnerID > 0 {
if _, ok := h.repo.User(v.OwnerID); !ok {
c.JSON(400, map[string]string{"error": "project owner must reference an existing user"})
return
}
}
seenMembers := map[int64]bool{}
for _, member := range v.Members {
if member.UserID <= 0 || seenMembers[member.UserID] {
c.JSON(400, map[string]string{"error": "project members must reference unique existing users"})
return
}
if _, ok := h.repo.User(member.UserID); !ok {
c.JSON(400, map[string]string{"error": "project member must reference an existing user"})
return
}
seenMembers[member.UserID] = true
}
if v.DefaultRepositoryID != "" {
repo, ok := h.repo.Repository(v.DefaultRepositoryID)
if !ok || repo.ProjectID != v.ID {
c.JSON(400, map[string]string{"error": "default repository must belong to project"})
return
}
}
if v.Key == "" {
v.Key = strings.ToUpper(v.ID)
}
v.TAPDWorkspaceID = strings.TrimSpace(v.TAPDWorkspaceID)
v.TAPDIterationID = strings.TrimSpace(v.TAPDIterationID)
if existing, ok := h.repo.Project(v.ID); ok {
if body.TAPDClear {
v.TAPDWorkspaceID = ""
v.TAPDIterationID = ""
} else {
if v.TAPDWorkspaceID == "" {
v.TAPDWorkspaceID = existing.TAPDWorkspaceID
}
if v.TAPDIterationID == "" {
v.TAPDIterationID = existing.TAPDIterationID
}
}
} else {
if body.TAPDClear {
v.TAPDWorkspaceID = ""
v.TAPDIterationID = ""
}
}
if existing, ok := h.repo.Project(v.ID); ok && v.RunEval.IsZero() {
v.RunEval = existing.RunEval
} else if !v.RunEval.IsZero() {
v.RunEval = domain.EffectiveRunEvalPolicy(v.RunEval)
}
if err := h.repo.PutProject(v); err != nil {
respond(c, err)
return
}
if isNew {
if err := ensureDefaultProjectMCPs(h.repo, v.ID); err != nil {
log.Printf("ensure default MCPs for project %s: %v", v.ID, err)
} else {
h.configureSync(h.repo.SyncConfig())
}
}
stored, _ := h.repo.Project(v.ID)
c.JSON(200, domain.PublicProject(stored))
return
}
}
func (h *projectsHandlers) applyProjectPlaybook(project *domain.Project) error {
if project == nil {
return nil
}
if project.SOPPlaybooks != nil {
books := domain.NormalizeSOPPlaybooks(project.SOPPlaybooks)
for i := range books {
bindings, err := normalizeSOPBindings(h.repo, project.ID, books[i].Bindings)
if err != nil {
return err
}
books[i].Bindings = bindings
}
project.SOPPlaybooks = books
if book, ok := project.DefaultPlaybook(); ok && len(book.Bindings) > 0 {
project.WorkflowID = book.Bindings[0].WorkflowID
}
return nil
}
if project.SOPBindings == nil {
return nil
}
bindings, err := normalizeSOPBindings(h.repo, project.ID, project.SOPBindings)
if err != nil {
return err
}
if len(bindings) == 0 {
project.SOPBindings = nil
return nil
}
project.SOPBindings = bindings
project.WorkflowID = bindings[0].WorkflowID
return nil
}
func (h *projectsHandlers) project(c *gin.Context) {
project, ok := h.repo.Project(c.Param("id"))
if !ok {
c.JSON(http.StatusNotFound, map[string]string{"error": "project not found"})
return
}
c.JSON(http.StatusOK, domain.PublicProject(project))
}
// deleteProject hides a project (soft delete). Requirements, runs, settings
// and members are kept so restoreProject can bring it back. Running work and
// enabled schedules must be stopped first so nothing keeps acting on a
// project nobody can see.
func (h *projectsHandlers) deleteProject(c *gin.Context) {
p, uid, ok := h.projectForArchive(c)
if !ok {
return
}
if p.ArchivedAt != nil {
c.JSON(http.StatusNotFound, gin.H{"error": "项目不存在或已删除"})
return
}
if blockers := h.projectDeleteBlockers(p.ID); len(blockers) > 0 {
c.JSON(http.StatusConflict, gin.H{"error": "项目「" + p.Name + "」还有" + strings.Join(blockers, "、") + ",请先停止后再删除"})
return
}
now := time.Now().UTC()
if err := h.repo.SetProjectArchived(p.ID, &now, uid); err != nil {
respond(c, err)
return
}
stored, _ := h.repo.Project(p.ID)
c.JSON(http.StatusOK, domain.PublicProject(stored))
}
func (h *projectsHandlers) restoreProject(c *gin.Context) {
p, _, ok := h.projectForArchive(c)
if !ok {
return
}
if p.ArchivedAt != nil {
if err := h.repo.SetProjectArchived(p.ID, nil, 0); err != nil {
respond(c, err)
return
}
}
stored, _ := h.repo.Project(p.ID)
c.JSON(http.StatusOK, domain.PublicProject(stored))
}
func (h *projectsHandlers) projectForArchive(c *gin.Context) (domain.Project, int64, bool) {
p, ok := h.repo.Project(c.Param("id"))
if !ok {
c.JSON(http.StatusNotFound, gin.H{"error": "项目不存在"})
return domain.Project{}, 0, false
}
if !authRequired() {
return p, 0, true
}
user, ok := h.requestUser(c.Request, true)
if !ok {
c.JSON(http.StatusUnauthorized, gin.H{"error": "请先登录"})
return domain.Project{}, 0, false
}
if p.OwnerID != user.ID && !h.isPlatformAdmin(c.Request) {
c.JSON(http.StatusForbidden, gin.H{"error": "只有项目 Owner 或平台管理员可以删除或恢复项目"})
return domain.Project{}, 0, false
}
return p, user.ID, true
}
func (h *projectsHandlers) projectDeleteBlockers(projectID string) []string {
var out []string
runs, err := h.repo.RunSummariesFor(domain.AnalyticsFilter{ProjectIDs: []string{projectID}}, "")
if err != nil {
return []string{"运行记录无法读取"}
}
active := 0
for _, run := range h.repo.FilterRunsByProject(runs, projectID) {
if !domain.TerminalRunStatus(run.Status) {
active++
}
}
if active > 0 {
out = append(out, strconv.Itoa(active)+" 个未结束的运行")
}
var jobs []string
for _, job := range h.repo.ScheduleJobs() {
if job.Enabled && job.ProjectID == projectID {
jobs = append(jobs, "「"+job.Name+"」")
}
}
if len(jobs) > 0 {
out = append(out, "启用中的定时任务"+strings.Join(jobs, ""))
}
return out
}
func (h *projectsHandlers) businessDomainAssignment(c *gin.Context) {
uid, admin := businessDomainIdentity(h.deps, c.Request)
p, ok := h.repo.Project(c.Param("id"))
if !ok {
c.JSON(404, gin.H{"error": "项目不存在"})
return
}
if c.Request.Method == http.MethodGet {
if !admin && p.OwnerID != uid {
c.JSON(403, gin.H{"error": "只有平台管理员和项目 Owner 可以查看归属历史"})
return
}
rows, err := h.repo.ProjectBusinessDomainHistory(p.ID)
if err != nil {
respond(c, err)
return
}
c.JSON(200, rows)
return
}
var body struct {
BusinessDomainID string `json:"businessDomainId"`
ExpectedDomainID string `json:"expectedDomainId"`
Reason string `json:"reason"`
}
if !decode(c, &body) {
return
}
body.BusinessDomainID = strings.TrimSpace(body.BusinessDomainID)
body.ExpectedDomainID = strings.TrimSpace(body.ExpectedDomainID)
body.Reason = strings.TrimSpace(body.Reason)
if !admin && (uid <= 0 || p.OwnerID != uid || p.BusinessDomainID != "") {
c.JSON(403, gin.H{"error": "项目 Owner 只能设置首次归属;迁移或清除归属需要平台管理员"})
return
}
if len([]rune(body.Reason)) > 500 {
c.JSON(400, gin.H{"error": "归属调整原因不能超过 500 字"})
return
}
err := h.repo.SetProjectBusinessDomain(p.ID, body.ExpectedDomainID, body.BusinessDomainID, uid, body.Reason, !admin)
if err != nil {
switch {
case errors.Is(err, repo.ErrBusinessAssignmentForbidden):
c.JSON(403, gin.H{"error": err.Error()})
case errors.Is(err, repo.ErrBusinessAssignmentConflict):
c.JSON(409, gin.H{"error": err.Error()})
case errors.Is(err, gorm.ErrRecordNotFound):
c.JSON(404, gin.H{"error": "项目或业务域不存在"})
default:
c.JSON(400, gin.H{"error": err.Error()})
}
return
}
p, ok = h.repo.Project(p.ID)
if !ok {
c.JSON(500, gin.H{"error": "业务归属已更新,但读取项目失败,请刷新后重试"})
return
}
c.JSON(200, domain.PublicProject(p))
}