feat: Implement Issue Categorization AI endpoint #133
Description
Overview
Implement AI-powered issue categorization to help leaders classify operational issues by type and severity. This endpoint supports the issue resolution workflow by providing structured categorization.
Topic: Issue Categorization (\categorize_issue)
Current Registry Entry:
\\python
"POST:/operations/categorize-issue": EndpointDefinition(
endpoint_path="/operations/categorize-issue",
http_method="POST",
topic_id="categorize_issue",
response_model="IssueCategoryResponse",
topic_type=TopicType.SINGLE_SHOT,
category=TopicCategory.OPERATIONS_AI,
description="Categorize operational issue by type and severity",
is_active=False, # Currently disabled
parameter_refs=(_issue("issue"),),
)
\\
Use Case
- User reports an issue (title + description)
- AI analyzes and categorizes the issue
- Returns structured categorization for tracking and prioritization
Expected Response
\\json
{
"issue_title": "Customer onboarding completion rate dropped",
"category": {
"primary": "customer_experience",
"secondary": "onboarding",
"tags": ["retention", "ux", "conversion"]
},
"severity": {
"level": "high",
"score": 8,
"reasoning": "Direct impact on customer acquisition and retention metrics"
},
"urgency": {
"level": "medium",
"recommended_timeline": "2 weeks",
"reasoning": "Trend indicates ongoing decline, but not immediate crisis"
},
"affected_areas": ["Sales", "Customer Success", "Product"],
"suggested_owner": "Customer Success Team",
"related_kpis": ["Customer Acquisition Cost", "Churn Rate", "NPS"],
"recommendations": [
"Investigate recent product changes",
"Review customer feedback from dropouts",
"Compare with competitor onboarding flows"
]
}
\\
Implementation Notes
- Integrate with issue entity structure
- May use predefined category taxonomy
- Severity scoring should be consistent and explainable
- Could link to KPIs and goals for impact assessment
Dependencies
- Response model: IssueCategoryResponse
- Issue entity integration
- Category taxonomy definition
Acceptance Criteria
- \POST /operations/categorize-issue\ accepts issue details
- Returns structured categorization with severity and urgency
- Categories align with business domain taxonomy
- Integrates with issue tracking workflow
- Unit tests with 80%+ coverage
Related Issues
- feat: Implement Root Cause Analysis AI endpoints (SWOT, Five Whys) #132 - Root Cause Analysis (SWOT, Five Whys)
- Impact Assessment (separate issue)
- Action Plan Optimization (separate issue)