| Server IP : 167.235.224.122 / Your IP : 216.73.216.110 Web Server : Apache/2.4.58 (Ubuntu) System : Linux newplayground 6.8.0-136-generic #136-Ubuntu SMP PREEMPT_DYNAMIC Wed Jul 1 21:33:11 UTC 2026 aarch64 User : deploy ( 1000) PHP Version : 8.4.23 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /var/www/html/emajiwallet/ |
Upload File : |
# Summative Credentials Implementation
**Date:** January 4, 2026
**Status:** ✅ Complete
## Overview
Implemented support for summative credentials (degrees/certifications) that represent profession baseline requirements, replacing the display of 132+ individual component skills with a single clean credential icon.
---
## Changes Made
### 1. Database Schema
**Migration:** `2026_01_04_174318_add_summative_qualification_to_professions_table.php`
Added `summative_qualification_id` to `professions` table:
```php
Schema::table('professions', function (Blueprint $table) {
$table->unsignedBigInteger('summative_qualification_id')->nullable();
$table->foreign('summative_qualification_id')
->references('id')
->on('qualifications')
->onDelete('set null');
});
```
### 2. Profession Model
**File:** `app/Models/Profession.php`
**Changes:**
- Added `summative_qualification_id` to `$fillable`
- Added relationship method:
```php
public function summativeQualification()
{
return $this->belongsTo(Qualification::class, 'summative_qualification_id');
}
```
### 3. JobController
**File:** `app/Http/Controllers/JobController.php` (Line 32)
**Changes:**
- Added eager loading of summative qualification:
```php
$job = Job::with([
'profession.qualifications',
'profession.summativeQualification', // <-- NEW
'organization',
'qualifications'
])
```
### 4. Job Details View
**File:** `resources/views/job_details.blade.php` (Lines 192-210)
**Old Behavior:**
- Showed alert box with generic text
- Displayed collapsible section with 132+ individual skill icons
- Overwhelming and cluttered
**New Behavior:**
- Shows single clean square icon for the summative credential (e.g., "Bachelor of Science in Nursing")
- Clickable icon opens modal → links to qualification details page
- Much cleaner UX
```blade
@if($job->profession && $job->profession->summativeQualification)
<section class="mb-5">
<h2 class="mt-4">
<i class="bi bi-mortarboard-fill me-2" style="color: var(--ios-indigo);"></i>
Profession Baseline Requirements
</h2>
<p class="text-muted small">
Professional degree or certification required for this position
(covers {{ $professionRequirements->count() }} core competencies)
</p>
<div class="row row-cols-2 row-cols-md-4 g-4 mt-2">
@include('partials.qualification_icon', [
'qualification' => $job->profession->summativeQualification,
'isCore' => true,
'owned' => isset($userQualificationIds) ?
$userQualificationIds->contains($job->profession->summativeQualification->id) : false
])
</div>
</section>
@endif
```
---
## Data Setup
Created sample data for testing:
**Qualification Created:**
- **ID:** 474
- **Title:** "Bachelor of Science in Nursing"
- **Type:** `degree`
- **Description:** "Professional degree covering all core nursing competencies required for specialist nursing practice"
- **is_credentialable:** `true`
**Linked to Profession:**
- **Profession ID:** 34
- **Profession Title:** "specialist nurse"
- **summative_qualification_id:** 474
---
## How It Works
### Display Logic
1. **Job Details Page:**
- If profession has a `summativeQualification`, show it as a single square icon
- Description mentions it covers X core competencies
- Icon is clickable → opens qualification modal
2. **Qualification Details Page (Future):**
- Will show all 132 component skills that this degree covers
- User can explore what the degree includes
3. **Pathway Creation (Future Enhancement):**
- Add only the summative credential to pathway
- Progress tracked as: "Do you have this degree? Yes/No"
- NOT tracking 132 individual skills
### Credential Verification
**Current System (Unchanged):**
- Each qualification (including degrees) verified through `credential_mappings` table
- User uploads credential with `achievement_id`
- System checks if that `achievement_id` exists in `credential_mappings` for the degree qualification
- **No automatic cascading** - degrees verified same as any other credential
**Future Enhancement:**
If a user has the BSN degree credential, the system COULD automatically mark all 132 component skills as proven. This would require adding logic to:
1. Check if user has degree credential
2. Look up which skills are included in that degree (via profession_qualification_requirements)
3. Automatically mark those skills as achieved
But for now, it's purely a UX improvement for display and pathway simplicity.
---
## Benefits
### 1. Cleaner Job Display
- **Before:** 132+ tiny skill icons overwhelming the user
- **After:** 1 clean degree icon + description
### 2. Simpler Pathways
- **Before:** Track progress on 132 individual skills
- **After:** Track progress on 1 degree credential
### 3. Better User Understanding
- Users immediately understand: "I need a BSN degree"
- Rather than: "I need these 132 random skills"
### 4. Flexible for Future
- Can add more complex logic later (partial degrees, equivalencies, etc.)
- Database structure supports it
---
## Next Steps (Optional Future Enhancements)
### 1. Qualification Details Page Update
Add section showing included skills:
```blade
@if($qualification->type === 'degree')
<section>
<h3>This degree covers the following competencies:</h3>
<div class="row">
@foreach($includedSkills as $skill)
@include('partials.qualification_icon', ['qualification' => $skill])
@endforeach
</div>
</section>
@endif
```
### 2. Pathway Progress Enhancement
Update pathway creation to only add degree (not component skills):
```php
if ($profession->summativeQualification) {
PathwayRequirement::create([
'pathway_id' => $pathway->id,
'type' => 'qualification',
'qualification_id' => $profession->summativeQualification->id,
'source_kind' => 'profession_baseline',
'informal' => false,
]);
} else {
// Fallback: add individual skills (old behavior)
}
```
### 3. Auto-Recognition Logic
When user proves they have the degree, automatically mark component skills as proven:
```php
if ($userHasDegreeCredential) {
$componentSkills = $profession->qualificationRequirements->pluck('qualification_id');
// Mark all component skills as proven for this user
}
```
### 4. Admin Interface
Create UI for admins to:
- Link professions to their summative credentials
- Create new degree qualifications
- Manage which skills are included in degrees
---
## Testing
### Verify the Implementation
1. **View Job Details:**
- Navigate to a specialist nurse job
- Should see single "Bachelor of Science in Nursing" icon
- Click icon → opens modal with degree details
2. **Create Pathway:**
- Start pathway for nursing job
- Should add only the degree (not 132 skills) - *if pathway logic updated*
3. **Progress Tracking:**
- Upload BSN credential
- System verifies via credential_mappings
- Pathway shows degree as completed
---
## Summary
Successfully implemented summative credentials system using existing `type` field on qualifications. The system now:
✅ Displays degrees cleanly on job details pages
✅ Links professions to their summative credentials
✅ Maintains all existing credential verification logic
✅ Sets foundation for simpler pathway tracking
✅ Improves user experience significantly
All changes are **production-ready** and **backward compatible** (jobs/professions without summative credentials still work as before).