feat: Implement Impact Assessment AI endpoint #134
Description
Overview
Implement AI-powered impact assessment to help leaders understand the business impact of operational issues. This endpoint provides structured analysis of how issues affect business goals, KPIs, and operations.
Topic: Impact Assessment (\�ssess_impact)
Current Registry Entry:
\\python
"POST:/operations/assess-impact": EndpointDefinition(
endpoint_path="/operations/assess-impact",
http_method="POST",
topic_id="assess_impact",
response_model="ImpactAssessmentResponse",
topic_type=TopicType.SINGLE_SHOT,
category=TopicCategory.OPERATIONS_AI,
description="Assess business impact of operational issue",
is_active=False, # Currently disabled
parameter_refs=(
_issue("issue"),
_onb("business_context"),
),
)
\\
Use Case
- User has identified an issue
- AI analyzes impact on business foundation, goals, and KPIs
- Returns comprehensive impact assessment to inform prioritization
Expected Response
\\json
{
"issue_summary": "Customer onboarding completion rate dropped 20%",
"overall_impact": {
"score": 75,
"level": "high",
"summary": "Significant impact on customer acquisition and retention goals"
},
"business_foundation_impact": {
"vision_alignment": "Conflicts with vision of customer-centric growth",
"purpose_impact": "Undermines purpose of delivering value to customers",
"values_affected": ["Customer First", "Excellence"]
},
"goal_impacts": [
{
"goal": "Increase customer retention to 95%",
"impact_level": "high",
"impact_description": "Directly reduces ability to retain new customers",
"estimated_effect": "-5% on retention rate"
},
{
"goal": "Achieve ARR",
"impact_level": "medium",
"impact_description": "Reduces conversion from trial to paid",
"estimated_effect": "- potential revenue"
}
],
"kpi_impacts": [
{
"kpi": "Customer Acquisition Cost",
"current_impact": "Increased by 15%",
"trend": "worsening"
},
{
"kpi": "Trial-to-Paid Conversion",
"current_impact": "Decreased by 8%",
"trend": "stable"
}
],
"operational_impacts": [
"Customer Success team overloaded with support requests",
"Sales team unable to upsell due to poor initial experience"
],
"financial_impact": {
"estimated_monthly_cost": 25000,
"estimated_annual_cost": 300000,
"confidence": "medium"
},
"recommendations": [
"Prioritize onboarding improvement initiative",
"Allocate additional CS resources short-term",
"Review product UX for quick wins"
],
"urgency": "Address within 2 weeks to prevent further degradation"
}
\\
Implementation Notes
- Requires integration with business foundation data (vision, purpose, values)
- Should connect to goals and KPIs for impact calculation
- Financial impact estimates based on business context
- Consider historical data for trend analysis
Dependencies
- Response model: ImpactAssessmentResponse
- Business foundation integration (onboarding data)
- Goals and KPIs integration
- Issue entity
Acceptance Criteria
- \POST /operations/assess-impact\ accepts issue and business context
- Returns comprehensive impact assessment across business dimensions
- Integrates with goals and KPIs for specific impact analysis
- Provides actionable recommendations based on impact
- Unit tests with 80%+ coverage
Related Issues
- feat: Implement Root Cause Analysis AI endpoints (SWOT, Five Whys) #132 - Root Cause Analysis (SWOT, Five Whys)
- feat: Implement Issue Categorization AI endpoint #133 - Issue Categorization
- Action Plan Optimization (separate issue)