Project Stage Progress Controller Documentation

File: /controllers/projectstagesdataController.php

Purpose: Track and manage progress data for each project stage with multimedia attachments

Last Updated: 2024-12-20

---

📋 Overview

Primary Functions

• ✅ Project stage progress tracking
• ✅ Stage completion with images and documents
• ✅ Progress reporting and visualization
• ✅ Multimedia file management for stages

Related Controllers

• • projectstagesController.php - Stage templates
• • projectController.php - Project master data

---

🗄️ Database Tables

Primary Tables

🔧 Key Functions

1. savedata()

Purpose: Update stage progress with multimedia attachments

Called By: AJAX POST to ?do=savedata

Parameters:

• • $projectstagechosseitr (int) - Number of stages to update
• • Multiple stage data arrays with images and files

Business Logic:

for ($i2=1; $i2 <= $projectstagechosseitr; $i2++) { 
    $projectstagechoid = filter_input(INPUT_POST, 'projectstagechoid'.$i2);
    $title = filter_input(INPUT_POST, 'title'.$i2);
    $descripe = filter_input(INPUT_POST, 'descripe'.$i2);
    
    // Handle file uploads
    if ($oldeimages) {
        if (isset($_FILES["projectstageimages".$i2]) && !empty($_FILES["projectstageimages".$i2])) {
            $projectstageimages = uploadfileMultipleWithName("projectstageimages".$i2, '../upload/project', explode(',', $oldeimages));
        }
    }
    
    if ($projectstagechoid) {
        $projectstagechosse = R::load('projectstagechosse',$projectstagechoid);
        $projectstagechosse->title = $title;
        $projectstagechosse->descripe = $descripe;
        $projectstagechosse->projectstageimages = implode(',', $projectstageimages[0]);
        $projectstagechosse->oldnameimages = implode(',', $projectstageimages[1]);
        $projectstagechosse->projectstagefiles = implode(',', $projectstagefiles[0]);
        $projectstagechosse->oldnamefiles = implode(',', $projectstagefiles[1]);
        R::store($projectstagechosse);
    }
}

2. Stage Data Processing

File Management:

$projectstagecho->images = explode(',', $projectstagecho->projectstageimages);
$projectstagefiles = explode(',', $projectstagecho->projectstagefiles);
$oldnamefiles = explode(',', $projectstagecho->oldnamefiles);
$files = [];
for ($i=0; $i < count($projectstagefiles); $i++) { 
    $files[] = ['name' => $oldnamefiles[$i], 'file' => $projectstagefiles[$i]];
}
$projectstagecho->files = $files;

---

🎯 URL Routes & Actions

⚠️ Known Issues & Fixes

Issue 1: Incorrect Table in Delete (Line 263)

Problem: References 'students' table instead of stage data

Cause: Copy-paste error from student controller

Fix: Replace with appropriate stage data table

File: Line 263

Issue 2: Duplicate Session Check (Lines 161-164)

Problem: Project session filtering logic duplicated

Cause: Copy-paste error

Fix: Remove duplicate condition

File: Lines 161-164

---

📚 Related Documentation

• • Stage Templates
• • Project Master
• • File Upload Library