Files
company-ai-platform/app/modules/reports/constants.py
JiuContinent fbd0aaa9e4 ```
refactor(api): 使用常量替代硬编码字符串

- 在health_check接口中使用ApiResponseKey.STATUS和ApiStatus.OK常量
- 替换硬编码的状态返回值为枚举常量

refactor(core): 配置模块错误信息统一使用常量

- 从constants模块导入ConfigErrorDetail并替换CORS_ORIGINS和LEGACY_ALLOWED_QUERIES的验证错误信息
- 配置类中的默认值使用constants中定义的常量

feat(constants): 添加API响应、安全错误和配置错误常量类

- 新增ApiResponseKey用于API状态键名
- 新增ApiStatus用于API状态值
- 新增SecurityErrorDetail用于安全认证错误详情
- 新增ConfigErrorDetail用于配置验证错误详情
- 添加DEFAULT_MODEL_PROVIDER和DEFAULT_OPENCLAW_ACTION_JSON常量

refactor(security): 安全认证模块使用错误常量

- 将硬编码的安全错误信息替换为SecurityErrorDetail常量
- 包括API密钥、审批密钥和审计密钥的相关错误信息

refactor(ai-agent): AI代理适配器改进错误处理

- 将HTTP状态码替换为FastAPI状态常量
- 添加OpenClaw工具和操作的错误常量
- 修复健康检查和工具调用中的状态码比较逻辑
- 添加AIToolAuditKey用于工具审计键名

feat(ai-agent): 扩展AI代理常量定义

- 新增AIToolAuditKey用于工具审计字段
- 添加OpenClaw相关的错误常量如OPENCLAW_CHAT_PROVIDER_REQUIRED等
- 添加UNSUPPORTED_AI_SKILL_TEMPLATE模板字符串

refactor(approvals): 审批模块常量化重构

- 新增ApprovalPayloadKey用于审批载荷字段
- 添加approval_action函数和APPROVAL_ACTION_SEPARATOR分隔符
- 使用常量替换字面量值

feat(audit): 审计模块新增飞书事件动作类型

- 添加FEISHU_WEBHOOK_EVENT和FEISHU_LONG_CONNECTION_EVENT审计动作

refactor(business): 业务模块全面常量化

- 新增BusinessDomain枚举包含所有业务域
- 添加BusinessResponseKey、BusinessPayloadKey等常量类
- 重构DOMAIN_MODELS为frozenset以提高性能
- 添加normalize_domain等辅助函数用于域标准化
- 使用常量替换路由和业务服务中的硬编码字符串
- 添加业务错误常量和字段验证模板

refactor(feishu): 飞书客户端错误处理优化

- 将HTTP状态码替换为FastAPI标准状态常量
- 改进错误处理的一致性

refactor(approvals): 审批服务使用新常量结构

- 使用ApprovalPayloadKey常量重构载荷字段
- 使用approval_action函数统一动作命名格式
- 优化高风险域判断逻辑
```
2026-07-06 15:56:43 +08:00

187 lines
5.4 KiB
Python

from enum import StrEnum
class ReportType(StrEnum):
DAILY = "daily"
WEEKLY = "weekly"
class ReportTitle(StrEnum):
DAILY_BRIEF = "每日经营晨报"
PROJECT_WEEKLY = "项目周报"
ATTENDANCE_SUMMARY = "打卡汇总"
WORK_DAILY = "经营日报"
WORK_WEEKLY = "经营周报"
PROJECT_LIFECYCLE = "项目全生命周期报告"
class ReportStatus(StrEnum):
UNKNOWN = "未设置"
GENERATED = "已生成"
class LifecycleSection(StrEnum):
HEALTH = "health"
PROJECTS = "projects"
TASKS = "tasks"
PROCUREMENTS = "procurements"
EXPENSES = "expenses"
FUNDS = "funds"
SUPPLIERS = "suppliers"
ATTENDANCE = "attendance"
RISKS = "risks"
class LifecycleFilterKey(StrEnum):
PROJECT_CODE = "project_code"
OWNER = "owner"
PERIOD_START = "period_start"
PERIOD_END = "period_end"
LABELS = "labels"
class LifecycleResponseKey(StrEnum):
TITLE = "title"
FILTERS = "filters"
METRICS = "metrics"
ATTENTION = "attention"
RECOMMENDATIONS = "recommendations"
LINES = "lines"
CONTENT = "content"
AI_ANALYSIS = "ai_analysis"
PROJECT_LIFECYCLE_REPORT = "project_lifecycle_report"
class ReportResponseKey(StrEnum):
REPORT = "report"
DATA = "data"
TITLE = "title"
REPORT_TYPE = "report_type"
PERIOD_START = "period_start"
PERIOD_END = "period_end"
WORK_DATE = "work_date"
TOTAL = "total"
ABNORMAL_TOTAL = "abnormal_total"
STATUS_COUNTS = "status_counts"
LINES = "lines"
CONTENT = "content"
METRICS = "metrics"
RISK_SUMMARY = "risk_summary"
class LifecycleAttentionKey(StrEnum):
DELAYED_PROJECTS = "delayed_projects"
OVER_BUDGET_PROJECTS = "over_budget_projects"
OVERDUE_TASKS = "overdue_tasks"
class MetricKey(StrEnum):
TOTAL = "total"
ACTIVE = "active"
CLOSED = "closed"
AVERAGE_PROGRESS_PERCENT = "average_progress_percent"
BY_STATUS = "by_status"
BY_RISK_LEVEL = "by_risk_level"
BUDGET_TOTAL = "budget_total"
ACTUAL_TOTAL = "actual_total"
BUDGET_USAGE_RATE = "budget_usage_rate"
DELAYED = "delayed"
OVER_BUDGET = "over_budget"
COMPLETED = "completed"
OPEN = "open"
OVERDUE = "overdue"
BLOCKED = "blocked"
COMPLETION_RATE = "completion_rate"
BY_PRIORITY = "by_priority"
PENDING_APPROVAL = "pending_approval"
PENDING_DELIVERY = "pending_delivery"
UNPAID = "unpaid"
EXPECTED_TOTAL = "expected_total"
ACTUAL_VS_EXPECTED_RATE = "actual_vs_expected_rate"
AMOUNT_TOTAL = "amount_total"
BY_TYPE = "by_type"
ACCOUNTS_TOTAL = "accounts_total"
CURRENT_BALANCE_TOTAL = "current_balance_total"
EXPECTED_RECEIVABLE_TOTAL = "expected_receivable_total"
EXPECTED_PAYABLE_TOTAL = "expected_payable_total"
SAFETY_LINE_TOTAL = "safety_line_total"
NET_POSITION = "net_position"
RISK_ACCOUNTS = "risk_accounts"
RISKY = "risky"
BLACKLISTED = "blacklisted"
ABNORMAL = "abnormal"
ABNORMAL_RATE = "abnormal_rate"
RISK_LEVEL = "risk_level"
RISK_SCORE = "risk_score"
OVERDUE_TASKS = "overdue_tasks"
DELAYED_PROJECTS = "delayed_projects"
OVER_BUDGET_PROJECTS = "over_budget_projects"
OPEN_EVENTS = "open_events"
HIGH_EVENTS = "high_events"
EXTERNAL_OPEN_EVENTS = "external_open_events"
EXTERNAL_HIGH_EVENTS = "external_high_events"
EVENTS_BY_TYPE = "events_by_type"
EVENTS_BY_LEVEL = "events_by_level"
SCORE = "score"
LEVEL = "level"
class WorkReportMetricKey(StrEnum):
PROJECTS_TOTAL = "projects_total"
ACTIVE_PROJECTS = "active_projects"
TASKS_TOTAL = "tasks_total"
TASKS_COMPLETED = "tasks_completed"
TASKS_OVERDUE = "tasks_overdue"
PROCUREMENTS_PENDING = "procurements_pending"
EXPENSES_PENDING = "expenses_pending"
ATTENDANCE_TOTAL = "attendance_total"
OPEN_RISK_EVENTS = "open_risk_events"
class HealthLevel(StrEnum):
HEALTHY = "healthy"
ATTENTION = "attention"
CRITICAL = "critical"
class ReportText(StrEnum):
DEFAULT_SCOPE = "全部项目"
ACTION_HEADER = "- 建议动作:"
RECOMMEND_DELAYED = (
"优先组织延期项目复盘,明确新截止时间、负责人和资源缺口。"
)
RECOMMEND_OVER_BUDGET = (
"对超预算项目冻结非必要采购和费用,补齐预算调整审批依据。"
)
RECOMMEND_OVERDUE_TASKS = (
"清理逾期任务,要求负责人更新阻塞项和恢复计划。"
)
RECOMMEND_APPROVALS = "集中处理采购和费用审批,减少交付与付款等待。"
RECOMMEND_FUNDS = "复核资金安全线账户,滚动更新收付款预测。"
RECOMMEND_SUPPLIERS = "复核中高风险供应商,准备替代供应和履约跟踪。"
RECOMMEND_STABLE = (
"当前生命周期指标稳定,建议继续保持周度复盘和风险事件归档。"
)
LIFECYCLE_RISK_SCORE_WEIGHTS = {
MetricKey.OVERDUE_TASKS: 1,
MetricKey.DELAYED_PROJECTS: 3,
MetricKey.OVER_BUDGET_PROJECTS: 4,
MetricKey.EXTERNAL_OPEN_EVENTS: 2,
MetricKey.EXTERNAL_HIGH_EVENTS: 3,
}
HEALTH_PENALTY_WEIGHTS = {
MetricKey.OVERDUE_TASKS: 3,
MetricKey.DELAYED_PROJECTS: 8,
MetricKey.OVER_BUDGET_PROJECTS: 10,
MetricKey.EXTERNAL_HIGH_EVENTS: 8,
MetricKey.BUDGET_USAGE_RATE: 0.4,
MetricKey.COMPLETION_RATE: 0.1,
MetricKey.BLACKLISTED: 10,
}
HEALTH_SCORE_MAX = 100
HEALTH_SCORE_MIN = 0
HEALTHY_SCORE_THRESHOLD = 80
ATTENTION_SCORE_THRESHOLD = 60