SuccessionPipelineRole

A SuccessionPipelineRole is a titled slot on a succession map — the position being succeeded — that pipeline members are grouped under.

Purpose

Succession maps are organised by role rather than as a flat list. Roles are created inline while editing a map and carry nothing but a title. Members reference a role optionally, so a member can sit on a pipeline without belonging to any role. Roles touch their parent pipeline so that a rename or reorder keeps the pipeline card’s “last updated” value honest.

Usage

Roles are managed by the succession controllers alongside their pipeline.

• app/Http/Controllers/Projects/SuccessionPipelineRoleStoreController.php — creates a role inline.
• app/Http/Controllers/Projects/SuccessionPipelineRoleUpdateController.php — renames a role.
• app/Http/Controllers/Projects/SuccessionPipelineRoleDestroyController.php — deletes a role.
• app/Services/SuccessionPipelineService.php — eager loads roles in display order for the payload.

Relationships

Relation	Type	Related model
pipeline	belongsTo	SuccessionPipeline
members	hasMany	SuccessionPipelineMember

$touches = ['pipeline'] means saving a role updates the pipeline’s updated_at.

Data shape

Table succession_pipeline_roles. Primary key is a UUID (HasUuids).

Column	Type	Notes
id	uuid	Primary key
succession_pipeline_id	uuid	FK to succession_pipelines
title	string	Role title
created_at, updated_at	datetime	Timestamps

The role carries no organisation column; tenancy is inherited from its pipeline.