API 参考文档
项目成熟度评估 API
评估项目在各个维度的成熟度水平，生成综合评分和建议
POST /api/v1/assess-maturity
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| project_id | string | 是 | 项目唯一标识符 |
| dimensions | object | 是 | 各维度评估数据 |
| dimensions.planning | number | 是 | 规划维度评分 (0-100) |
| dimensions.execution | number | 是 | 执行维度评分 (0-100) |
| dimensions.risk | number | 是 | 风险维度评分 (0-100) |
| dimensions.quality | number | 是 | 质量维度评分 (0-100) |
| dimensions.communication | number | 是 | 沟通维度评分 (0-100) |
请求示例
{
"project_id": "proj-12345",
"dimensions": {
"planning": 85,
"execution": 75,
"risk": 65,
"quality": 90,
"communication": 80
}
}
响应示例
{
"success": true,
"data": {
"overall_score": 80,
"dimensions": {
"planning": 85,
"execution": 75,
"risk": 65,
"quality": 90,
"communication": 80
},
"recommendations": [
"加强风险管理流程",
"优化执行环节的效率"
],
"quadrant": "执行黑盒区"
},
"message": "评估完成"
}
标准差异审查 API
分析项目与标准流程的差异，生成审查报告
POST /api/v1/standard-review
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| project_id | string | 是 | 项目唯一标识符 |
| standard_id | string | 是 | 标准流程标识符 |
| project_processes | array | 是 | 项目实际流程 |
请求示例
{
"project_id": "proj-12345",
"standard_id": "std-agile-1.0",
"project_processes": [
"需求收集",
"迭代规划",
"开发",
"测试",
"部署"
]
}
响应示例
{
"success": true,
"data": {
"standard_id": "std-agile-1.0",
"missing_processes": [
"每日站会",
"回顾会议"
],
"deviations": [
{
"process": "需求收集",
"deviation": "缺少用户故事映射"
}
],
"compliance_score": 75
},
"message": "审查完成"
}
技术争议决策 API
分析技术争议，提供决策建议
POST /api/v1/tech-decision
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| dispute_id | string | 是 | 争议唯一标识符 |
| title | string | 是 | 争议标题 |
| description | string | 是 | 争议详细描述 |
| options | array | 是 | 可选方案列表 |
| criteria | object | 是 | 评估标准及权重 |
请求示例
{
"dispute_id": "dis-123",
"title": "框架选择",
"description": "前端框架选择React还是Vue",
"options": ["React", "Vue"],
"criteria": {
"性能": 0.3,
"生态": 0.25,
"团队熟悉度": 0.25,
"维护成本": 0.2
}
}
响应示例
{
"success": true,
"data": {
"recommended_option": "React",
"scores": {
"React": 85,
"Vue": 78
},
"reasoning": "基于性能和生态系统考虑，React更适合当前项目需求",
"risks": ["学习曲线较陡峭"]
},
"message": "决策分析完成"
}
发布策略模拟器 API
模拟发布策略，评估风险并生成策略说明书
POST /api/v1/release-strategy
功能说明
发布策略模拟器API提供以下核心功能：
- 策略配置：支持动态配置发布策略参数，包括ECR版本、数据窗口、验证周期等
- 风险评估：基于策略参数自动评估发布风险等级，识别潜在风险点
- AI智能生成：调用AI生成详细的风险评估报告和策略说明书
- 场景模拟：自动生成问题场景，帮助团队预判发布过程中可能遇到的问题
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| strategy_name | string | 是 | 策略名称 |
| ecr_version | string | 是 | ECR版本（草版/正式版） |
| data_window | string | 是 | 数据修改窗口（固定/灵活） |
| validation_period | number | 是 | 验证周期（天） |
| rollback_enabled | boolean | 否 | 是否启用回滚机制 |
| stakeholder_notify | boolean | 否 | 是否通知相关方 |
请求示例
{
"strategy_name": "草版ECR + 固定修改数据窗口",
"ecr_version": "draft",
"data_window": "fixed",
"validation_period": 7,
"rollback_enabled": true,
"stakeholder_notify": true
}
响应示例
{
"success": true,
"data": {
"strategy_id": "str-001",
"risk_level": "medium",
"risk_score": 45,
"risk_factors": [
"草版ECR可能存在未发现的问题",
"固定窗口可能限制灵活性"
],
"recommendations": [
"建议增加验证周期至14天",
"准备完整的回滚方案"
],
"ai_report_url": "/api/v1/reports/str-001",
"estimated_release_date": "2026-04-15"
},
"message": "策略评估完成"
}
AI智能分析 API
基于大语言模型的智能分析服务，支持自然语言交互
POST /api/v1/ai-analyze
功能说明
AI智能分析API提供以下能力：
- 智能问答：回答项目管理相关问题，提供专业建议
- 报告生成：自动生成风险评估报告、策略说明书等文档
- 数据分析：分析项目数据，识别潜在问题和改进机会
- 决策支持：基于多维度分析提供决策建议
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| prompt | string | 是 | 用户输入的问题或任务描述 |
| context | object | 否 | 上下文信息（项目数据等） |
| model | string | 否 | AI模型选择（默认：gpt-4） |
| temperature | number | 否 | 生成温度（0-1，默认：0.7） |
请求示例
{
"prompt": "请分析当前项目的风险状况并给出建议",
"context": {
"project_id": "proj-12345",
"current_phase": "执行阶段",
"issues": ["进度延迟", "资源不足"]
},
"model": "gpt-4",
"temperature": 0.7
}
响应示例
{
"success": true,
"data": {
"analysis": "基于当前项目状态分析...",
"recommendations": [
"立即召开紧急会议评估进度延迟原因",
"申请额外资源或调整项目范围"
],
"risk_alerts": [
{
"level": "high",
"description": "进度延迟可能导致交付风险"
}
],
"next_steps": ["制定恢复计划", "与相关方沟通"]
},
"message": "分析完成"
}