[Phase 1] Disable project creation endpoint in backend for single-namespace mode

[jeremyeder]

Epic: #1
Phase: 1 - Foundation & Code Changes
Dependencies: None (parallel with #2)
Estimate: 3 hours

Description

Disable the CreateProject endpoint in the backend API when running in single-namespace mode, since the backend cannot create namespaces without cluster-wide permissions.

Critical Issues Addressed

• ✅ Namespace creation not disabled in backend ([Phase 1] Add SINGLE_NAMESPACE_MODE support to operator #2)

Implementation Tasks

1. Add SINGLE_NAMESPACE_MODE Environment Variable

File: components/backend/internal/handlers/projects.go

Modify CreateProject() function (line ~98):

func CreateProject(c *gin.Context) {
    // Check if running in single-namespace mode
    if os.Getenv("SINGLE_NAMESPACE_MODE") == "true" {
        c.JSON(http.StatusNotImplemented, gin.H{
            "error": "Project creation disabled in single-namespace mode",
            "message": "This deployment only supports the namespace: vteam--test1",
            "contact": "Contact platform administrator to provision additional namespaces",
        })
        return
    }
    
    // ... existing implementation for multi-namespace mode ...
}

2. Update Backend Deployment Manifest

File: components/manifests/backend-deployment.yaml (to be updated in Phase 3)

Add environment variable:

env:
- name: SINGLE_NAMESPACE_MODE
  value: "false"  # Default to multi-namespace mode

Testing Requirements

• Backend returns HTTP 501 when SINGLE_NAMESPACE_MODE=true
• Error message is clear and actionable
• Existing functionality works when SINGLE_NAMESPACE_MODE=false
• Frontend handles 501 response gracefully

Acceptance Criteria

• CreateProject returns 501 in single-namespace mode
• Error message includes helpful guidance
• Existing multi-namespace functionality unchanged
• Environment variable documented
• Code reviewed and tested

Files Changed

• components/backend/internal/handlers/projects.go

Future Work (Phase 2)

• Frontend feature flag to hide "Create Project" button
• UI message explaining single-namespace limitation

Branch

feature/mpp-single-namespace-mode

[jeremyeder]

@claude begin implementation.

[claude]

Claude finished @jeremyeder's task —— View job • claude/issue-3-20251002-1920 • Create PR ➔

---

Implementation Complete

Successfully implemented the changes for issue #3: Disable project creation endpoint in backend for single-namespace mode.

Task Checklist

• Read current projects.go file
• Add os import to the file
• Add SINGLE_NAMESPACE_MODE environment variable check to CreateProject() function
• Commit and push changes
• Provide PR creation link

Changes Made

File Modified: components/backend/internal/handlers/projects.go

1. Added os import to support environment variable checking
2. Added environment variable check at the beginning of CreateProject() function (line 100-108)
3. Returns HTTP 501 (Not Implemented) when SINGLE_NAMESPACE_MODE=true
4. Includes helpful error message with guidance to contact platform administrator

Implementation Details

The CreateProject() function now checks for the SINGLE_NAMESPACE_MODE environment variable at the start. When set to "true", it returns:

{
  "error": "Project creation disabled in single-namespace mode",
  "message": "This deployment only supports the namespace: vteam--test1",
  "contact": "Contact platform administrator to provision additional namespaces"
}

The existing multi-namespace functionality remains unchanged when the environment variable is not set or set to any value other than "true".

---

Job Run | Branch

[jeremyeder]

@claude open a PR for this.

[claude]

Claude finished @jeremyeder's task —— View job • claude/issue-3-20251002-1924 • Create PR ➔

---

Task Complete

Task Checklist

• Check current branch and git status
• Verify if changes from issue [Phase 1] Disable project creation endpoint in backend for single-namespace mode #3 exist on current branch
• Apply changes for issue [Phase 1] Disable project creation endpoint in backend for single-namespace mode #3 (add SINGLE_NAMESPACE_MODE check)
• Commit and push changes
• Provide PR creation link

Summary

Successfully implemented and pushed the changes for issue #3 to branch claude/issue-3-20251002-1924.

Changes Made

File Modified: components/backend/internal/handlers/projects.go

1. Added os import to support environment variable checking
2. Added SINGLE_NAMESPACE_MODE environment variable check at the beginning of CreateProject() function (line 100-108)
3. Returns HTTP 501 (Not Implemented) when SINGLE_NAMESPACE_MODE=true with helpful error message

Implementation Details

The CreateProject() function now checks for the SINGLE_NAMESPACE_MODE environment variable at the start. When set to "true", it returns:

{
  "error": "Project creation disabled in single-namespace mode",
  "message": "This deployment only supports the namespace: vteam--test1",
  "contact": "Contact platform administrator to provision additional namespaces"
}

The existing multi-namespace functionality remains unchanged when the environment variable is not set or set to any value other than "true".

---

Job Run | Branch