Scenario Configuration Screen
Component Detail
Description
Coordinator-facing settings screen that lists available scenario rule templates and allows toggling which scenarios are active for their chapter. Each scenario entry shows trigger condition, delay, and prompt text preview. Only accessible to users with coordinator or admin roles.
scenario-configuration-screen
Summaries
The Scenario Configuration Screen gives chapter coordinators direct control over which automated peer-support prompts are active for their members. By enabling the right prompts at the right time, coordinators can tailor the support experience to their chapter's specific culture and needs without involving technical staff. This translates to higher engagement from peer mentors, more timely interventions, and a differentiated product offering that competing platforms cannot easily replicate. Reduced reliance on developer involvement for configuration changes also lowers ongoing operational cost and accelerates the organisation's ability to respond to changing member needs.
This is a medium-complexity mobile UI screen scoped to coordinator and admin roles, requiring integration with the scenario-rule-repository and scenario-configuration-manager backend services. Development depends on both those services being stable and their APIs finalised before this screen can be completed and tested end-to-end. Role-based access control must be verified in testing, covering both positive (coordinator/admin) and negative (peer mentor) access cases. UI testing should cover toggle state persistence, navigation to detail views, and graceful handling of empty or error states.
No blocking infrastructure dependencies are anticipated beyond the two listed service integrations.
Implemented as a Flutter mobile UI component, ScenarioConfigurationScreen fetches the active rule list via scenario-rule-repository and delegates enable/disable operations to scenario-configuration-manager. The buildScenarioList() method renders a scrollable list of ScenarioRule objects, each represented by a buildScenarioToggleTile() widget showing trigger condition, delay, and a prompt text preview. onToggleScenario() emits a state mutation via scenario-configuration-manager and should optimistically update local UI state while awaiting confirmation. navigateToScenarioDetail() pushes to the detail edit route.
Access control must be enforced at the widget tree level using the current user's role, not just at the route level.
Responsibilities
- List all available scenario templates with descriptions
- Allow coordinators to enable or disable individual scenarios
- Display current configuration state per scenario
- Provide navigation to scenario detail edit view
Interfaces
ScenarioConfigurationScreen()
buildScenarioList(List<ScenarioRule> rules)
buildScenarioToggleTile(ScenarioRule rule)
onToggleScenario(String scenarioId, bool enabled)
navigateToScenarioDetail(String scenarioId)
Relationships
Dependencies (2)
Components this component depends on
Related Data Entities (1)
Data entities managed by this component