feat: 2026-04-15~05-02 累积变更基线 — AI 重构 + Runtime Context + DWS 修复

涵盖(每条对应已存的审计记录):
- AI 模块拆分:apps/backend/app/ai/apps -> prompts/(8 个 APP + app2a 派生)
  audit: 2026-04-20__ai-module-complete.md
- admin-web AI 管理套件:AIDashboard / AIOperations / AIRunLogs / AITriggers / TriggerManager
  audit: 2026-04-21__admin-web-ai-management-suite.md
- App2 财务洞察 prompt v3 -> v5.1 + 小程序 AI 接入(chat / board-finance)
  audit: 2026-04-22__app2_prompt_v5_1_and_miniprogram_ai_insight.md
- App2 prewarm 全过滤器 + AI 触发器 cron reschedule
  audit: 2026-04-21__app2-finance-prewarm-all-filters.md
  migration: 20260420_ai_trigger_jobs_and_app2_prewarm.sql / 20260421_app2_prewarm_cron_reschedule.sql
- AppType 联合类型对齐 + adminAiAppTypes.test.ts
  audit: 2026-04-30__admin_web_ai_app_type_alignment.md
- DashScope tokens_used 提取修复
  audit: 2026-04-30__backend_dashscope_tokens_used_extraction.md
- App3 线索完整详情 prompt
  audit: 2026-05-01__backend_app3_full_detail_prompt.md
- Runtime Context 沙箱(5-1~5-2 主线):
  - 后端 schema/service + admin_runtime_context / xcx_runtime_clock 两个 router
  - admin-web RuntimeContext.tsx + miniprogram runtime-clock.ts
  - migration: 20260501__runtime_context_sandbox.sql
  - tools/db/verify_admin_web_sandbox.py + verify_sandbox_end_to_end.py
  - database/changes: 7 份 sandbox_* 验证报告
- 飞球 DWS 修复:finance_area_daily 区域汇总 + task_engine 调整
  + RLS 视图业务日上界(migration 20260502 + scripts/ops/gen_rls_business_date_migration.py)

合规:
- .gitignore 启用 tmp/ 排除
- 不入仓:apps/etl/connectors/feiqiu/.env(API_TOKEN secret,本地修改保留)

待验证清单:
- docs/audit/changes/2026-05-04__cumulative_baseline_pending_verification.md
  每个主题的功能完整性 / 上线验证几乎都未收口,按优先级 P0~P3 逐一处理
This commit is contained in:
Neo
2026-05-04 02:30:19 +08:00
parent 2010034840
commit caf179a5da
130 changed files with 14543 additions and 2717 deletions

View File

@@ -196,6 +196,37 @@ class BatchRunConfirmResponse(BaseModel):
status: str # "started"
# ── 按需单 App 执行(/run/{app_type})──────────────────────
class RunAppRequest(BaseModel):
"""按需执行单个 App 请求体。
context 字段根据 app_type 不同有不同约束:
- app2_finance: site_id + time_dimension + areaarea 默认 all
- app3_clue / app7_customer: site_id + member_id
- app4_analysis / app5_tactics: site_id + member_id + assistant_id
- app6_note: site_id + member_id + note_content + noted_by_name
- app8_consolidation: site_id + member_id
"""
site_id: int
member_id: int | None = None
assistant_id: int | None = None
time_dimension: str | None = None
area: str | None = None # App2 专用,默认 all
note_content: str | None = None
noted_by_name: str | None = None
noted_by_created_at: str | None = None
class RunAppResponse(BaseModel):
"""按需执行单个 App 响应。"""
app_type: str
success: bool
result: dict | None = None # 百炼返回的 JSON成功时
error: str | None = None # 错误描述(失败时)
# ── 告警 ──────────────────────────────────────────────────
@@ -211,3 +242,64 @@ class AlertActionResponse(BaseModel):
"""告警操作(确认/忽略)响应。"""
id: int
alert_status: str
# ── 触发器管理biz.trigger_jobs─────────────────────────
class TriggerItem(BaseModel):
"""触发器单条记录。"""
id: int
job_name: str
job_type: str
trigger_condition: str # event / cron / interval
trigger_config: dict # {"event_name": ...} 或 {"cron_expression": ...}
status: str # enabled / disabled
description: str | None = None
last_run_at: str | None = None
next_run_at: str | None = None
last_error: str | None = None
class TriggerUpdateRequest(BaseModel):
"""触发器更新请求3 个字段至少填一个)。"""
status: str | None = None # enabled / disabled
cron_expression: str | None = None # 标准 5 段 cron
description: str | None = None
# ── 预热进度app2_finance 72 组合)───────────────────────
class PrewarmMissingItem(BaseModel):
"""缺失的预热组合项。"""
target_id: str # this_month__all
time_dimension: str
area: str
class PrewarmProgressResponse(BaseModel):
"""app2_finance 预热进度响应。"""
total: int # 固定 72
done: int
missing: list[PrewarmMissingItem]
last_updated: str | None = None
# ── 手动事件触发(越过去重)───────────────────────────────
class ManualTriggerRequest(BaseModel):
"""手动触发 AI 事件请求。"""
event_type: str # consumption / dws_completed / note_created / task_assigned
site_id: int
member_id: int | None = None
assistant_id: int | None = None
payload: dict | None = None
is_forced: bool = True # 默认跳过去重
class ManualTriggerResponse(BaseModel):
"""手动事件触发响应。"""
trigger_job_id: int
status: str = "pending"

View File

@@ -0,0 +1,48 @@
# -*- coding: utf-8 -*-
"""业务运行上下文 API Schema。"""
from __future__ import annotations
from datetime import date, datetime
from typing import Literal
from pydantic import BaseModel, Field
RuntimeMode = Literal["live", "sandbox"]
AIMode = Literal["live"]
class RuntimeContextResponse(BaseModel):
site_id: int
mode: RuntimeMode
business_day_start_hour: int
business_date: date
business_now: datetime
sandbox_date: date | None = None
sandbox_instance_id: str | None = None
ai_mode: AIMode = "live"
status: str = "active"
is_sandbox: bool = False
class RuntimeTransitionStep(BaseModel):
key: str
title: str
status: Literal["success", "skipped", "warning", "failed"]
detail: str = ""
count: int = 0
class RuntimeSwitchRequest(BaseModel):
site_id: int = Field(..., ge=1)
mode: RuntimeMode
sandbox_date: date | None = None
reset_sandbox: bool = True
reason: str | None = Field(default=None, max_length=500)
class RuntimeSwitchResponse(BaseModel):
context: RuntimeContextResponse
steps: list[RuntimeTransitionStep]