Administration

Platform administration and configuration

23 stories across 2 personas | Coverage: 23/23 (100%)

Overview

Administration

Platform administration covers the configuration and management of the system's reference data and settings. This includes device categories (with their environmental impact factors), device brands, repair skills, group tags, user roles and permissions, and platform-wide alerts.

What Admins can do

Admins manage all reference data for the platform:

• Categories -- View, edit, and configure device categories with CO2 footprints and weight factors that drive impact calculations
• Brands -- Create, edit, and delete device brands used in repair logging
• Skills -- Create, edit, and delete repair skills that volunteers can add to their profiles
• Group Tags -- Create, edit, and delete tags used to categorise groups
• Roles -- View all roles and edit the permissions assigned to each
• Alerts -- Create and update platform-wide alert banners shown to all users

What Guests can do

Guests can view currently active platform alerts.

Platform alerts

Persona	Story	Method	Tests
Admin	As an Admin, I can create a platform-wide alert	AlertController::addAlertv2	✅ Covered
Admin	As an Admin, I can update a platform alert	AlertController::updateAlertv2	✅ Covered
Guest	As a Guest, I can view active platform alerts	AlertController::listAlertsv2	✅ Covered

Reference data

Persona	Story	Method	Tests
Admin	As an Admin, I can delete a device brand	BrandsController::getDeleteBrand	✅ Covered
Admin	As an Admin, I can access the form to edit a device brand	BrandsController::getEditBrand	✅ Covered
Admin	As an Admin, I can view all device brands	BrandsController::index	✅ Covered
Admin	As an Admin, I can create a new device brand	BrandsController::postCreateBrand	✅ Covered
Admin	As an Admin, I can update a device brand	BrandsController::postEditBrand	✅ Covered
Admin	As an Admin, I can access the form to edit a device category	CategoryController::getEditCategory	✅ Covered
Admin	As an Admin, I can view all device categories	CategoryController::index	✅ Covered
Admin	As an Admin, I can update a device category's details and impact factors	CategoryController::postEditCategory	✅ Covered
Admin	As an Admin, I can delete a group tag	GroupTagsController::getDeleteTag	✅ Covered
Admin	As an Admin, I can access the form to edit a group tag	GroupTagsController::getEditTag	✅ Covered
Admin	As an Admin, I can view all group tags	GroupTagsController::index	✅ Covered
Admin	As an Admin, I can create a new group tag	GroupTagsController::postCreateTag	✅ Covered
Admin	As an Admin, I can update a group tag	GroupTagsController::postEditTag	✅ Covered
Admin	As an Admin, I can delete a repair skill	SkillsController::getDeleteSkill	✅ Covered
Admin	As an Admin, I can access the form to edit a repair skill	SkillsController::getEditSkill	✅ Covered
Admin	As an Admin, I can view all repair skills	SkillsController::index	✅ Covered
Admin	As an Admin, I can create a new repair skill	SkillsController::postCreateSkill	✅ Covered
Admin	As an Admin, I can update a repair skill	SkillsController::postEditSkill	✅ Covered

Roles & permissions

Persona	Story	Method	Tests
Admin	As an Admin, I can edit the permissions assigned to a role	RoleController::edit	✅ Covered
Admin	As an Admin, I can view all roles and their permissions	RoleController::index	✅ Covered

Source Files

• app/Http/Controllers/API/AlertController.php
• app/Http/Controllers/BrandsController.php
• app/Http/Controllers/CategoryController.php
• app/Http/Controllers/GroupTagsController.php
• app/Http/Controllers/RoleController.php
• app/Http/Controllers/SkillsController.php