Dev Projects

Overview

The Dev Projects system tracks code changes, manages versions, and integrates with Git for branch management.

Admin UI: https://admin-development.magiceverse.online/app/settings/dev-projects Location: /mnt/data/magic_omniverse/magic_dev_projects/

Project Fields

Field	Description
project_code	Auto-generated unique code
name	Project name
description	Detailed description
project_type	feature, bugfix, enhancement
status	draft, in_progress, testing, deployed
priority	low, normal, high, critical
version	major.minor.patch.build
assigned_to	Developer name
target_date	Expected completion
ticket_number	Linked support ticket number (e.g. TKT-0042)
ticket_id	Linked support ticket ID (for deep-link URLs)

API Endpoints

Project CRUD

# Create project
curl -X POST "https://admin-development.magiceverse.online/admin/dev-projects" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Feature", "description": "Description", "project_type": "feature"}'

# List projects
curl "https://admin-development.magiceverse.online/admin/dev-projects"

# Get project details by ID
curl "https://admin-development.magiceverse.online/admin/dev-projects?id=1"

# Get project details by code
curl "https://admin-development.magiceverse.online/admin/dev-projects?code=PROJ-2026-0007"

File Tracking

# Add files to project
curl -X POST "https://admin-development.magiceverse.online/admin/dev-projects/files" \
  -H "Content-Type: application/json" \
  -d '{"project_id": 1, "files": [
    {"file_path": "src/api/admin/aplt/orders/route.ts", "change_type": "modified"},
    {"file_path": "src/admin/routes/02-aplt-orders/page.tsx", "change_type": "modified"}
  ]}'

Changelog

# Log a change
curl -X POST "https://admin-development.magiceverse.online/admin/dev-projects/changelog" \
  -H "Content-Type: application/json" \
  -d '{"project_id": 1, "action": "fix", "description": "Fixed PDF margin", "changed_by": "developer"}'

Git Operations

# View diff
curl "https://admin-development.magiceverse.online/admin/dev-projects/diff?project_id=1"

# Commit changes
curl -X POST "https://admin-development.magiceverse.online/admin/dev-projects/commit" \
  -H "Content-Type: application/json" \
  -d '{"project_id": 1, "message": "Fix PDF generation margins"}'

# Browse project files
curl "https://admin-development.magiceverse.online/admin/dev-projects/browse?project_id=1"

Build & Status

# Rebuild tenant backend
curl -X POST "https://admin-development.magiceverse.online/admin/dev-projects/rebuild" \
  -H "Content-Type: application/json" \
  -d '{"project_id": 1, "tenant": "magic_brinxx"}'

# Check project status
curl "https://admin-development.magiceverse.online/admin/dev-projects/status?project_id=1"

# Get version info
curl "https://admin-development.magiceverse.online/admin/dev-projects/version"

Support Ticket Integration

Dev Projects can be linked to Portal support tickets for two-way navigation:

Deep-Linking URLs

• Portal ticket: https://portal.magiceverse.online/support?ticket={ticket_id}
• Dev project by code: https://admin-development.magiceverse.online/app/settings/dev-projects?code={project_code}
• Dev project by ID: https://admin-development.magiceverse.online/app/settings/dev-projects?project={id}

Creating a Dev Project from a Ticket

Staff can click “Dev Project Aanmaken” in the ticket sidebar to automatically create a linked dev project. This:

1. Maps ticket category to project type (bug → bugfix, feature → feature)
2. Maps ticket priority to project priority (urgent → critical, etc.)
3. Creates the project via internal API (localhost:4010)
4. Updates both the MySQL ticket (dev_project_id, dev_project_branch) and the PostgreSQL project (ticket_number, ticket_id)

Navigating Between Systems

• From ticket: Click the dev project link in the Beheer card sidebar → opens Medusa admin at ?code={project_code}
• From dev project: Click the orange ticket badge in the project header or overview tab → opens Portal at ?ticket={ticket_id}

Ticket Detail Sidebar Integration

The dev project link appears in the Beheer card (third group, after assignment fields). If no dev project is linked, staff see a green “Dev Project Aanmaken” button. If linked, the project code is shown as a clickable link that opens the Medusa admin dev projects page with the project auto-selected.

API: Create Dev Project from Ticket

curl -X POST "https://portal.magiceverse.online/api/support/tickets/{id}/create-dev-project" \
  --cookie "session=..."

Git Integration

• Repository: /mnt/data/magic_omniverse/magic_commerce/magic_development
• Branch pattern: dev-project/{projectCode}
• Commit author: Dev Projects Bot
• Operations: branch, commit, diff, status