#!/usr/bin/env python3
from __future__ import annotations
import argparse
import html
import json
import os
from datetime import UTC, datetime
from decimal import Decimal
from pathlib import Path
from typing import Any
from urllib.parse import quote
import clickhouse_connect
import uvicorn
from fastapi import FastAPI, HTTPException, Query
from fastapi.responses import HTMLResponse, PlainTextResponse, Response
def parse_args() -> argparse.Namespace:
p = argparse.ArgumentParser(description="Read-only company intelligence API for analytics_1c")
p.add_argument("--host", default=os.getenv("AW_1C_COMPANY_API_HOST", "127.0.0.1"))
p.add_argument("--port", type=int, default=int(os.getenv("AW_1C_COMPANY_API_PORT", "8710")))
return p.parse_args()
def q(value: str) -> str:
return "'" + value.replace("'", "''") + "'"
def to_plain(value: Any) -> Any:
if isinstance(value, Decimal):
return float(value)
if isinstance(value, datetime):
return value.isoformat()
return value
def rows_to_dict(result) -> list[dict[str, Any]]:
return [
{name: to_plain(value) for name, value in zip(result.column_names, row)}
for row in result.result_rows
]
def ch_client():
return clickhouse_connect.get_client(
host=os.getenv("CLICKHOUSE_HOST", "localhost"),
port=int(os.getenv("CLICKHOUSE_PORT", "8123")),
username=os.getenv("CLICKHOUSE_USER", "default"),
password=os.getenv("CLICKHOUSE_PASSWORD", ""),
database=os.getenv("CLICKHOUSE_DB", "analytics_1c"),
)
def manager_brief_state_dir() -> Path:
root = Path(os.getenv("AW_1C_ROOT", "/opt/activitywatch/clickhouse-1c"))
configured = os.getenv("AW_1C_MANAGER_BRIEF_STATE_DIR")
if configured:
return Path(configured)
return root / "state" / "manager-brief"
def weekly_digest_state_dir() -> Path:
root = Path(os.getenv("AW_1C_ROOT", "/opt/activitywatch/clickhouse-1c"))
configured = os.getenv("AW_1C_WEEKLY_DIGEST_STATE_DIR")
if configured:
return Path(configured)
return root / "state" / "weekly-digest"
def recovery_brief_state_dir() -> Path:
root = Path(os.getenv("AW_1C_ROOT", "/opt/activitywatch/clickhouse-1c"))
configured = os.getenv("AW_1C_RECOVERY_BRIEF_STATE_DIR")
if configured:
return Path(configured)
return root / "state" / "recovery-brief"
def load_latest_manager_brief() -> dict[str, Any]:
latest_path = manager_brief_state_dir() / "latest.json"
if not latest_path.exists():
raise HTTPException(status_code=404, detail="manager brief not generated yet")
return json.loads(latest_path.read_text(encoding="utf-8"))
def load_latest_weekly_digest() -> dict[str, Any]:
latest_path = weekly_digest_state_dir() / "latest.json"
if not latest_path.exists():
raise HTTPException(status_code=404, detail="weekly digest not generated yet")
return json.loads(latest_path.read_text(encoding="utf-8"))
def load_latest_recovery_brief() -> dict[str, Any]:
latest_path = recovery_brief_state_dir() / "latest.json"
if not latest_path.exists():
raise HTTPException(status_code=404, detail="recovery brief not generated yet")
return json.loads(latest_path.read_text(encoding="utf-8"))
def load_brief_history_records(limit: int = 20) -> list[dict[str, Any]]:
history_dir = manager_brief_state_dir() / "history"
if not history_dir.exists():
return []
items: list[dict[str, Any]] = []
for path in sorted(history_dir.glob("*.json"), reverse=True)[:limit]:
payload = json.loads(path.read_text(encoding="utf-8"))
items.append(
{
"generated_at": payload.get("generated_at"),
"render_mode": payload.get("render_mode"),
"model": payload.get("model"),
"headline": payload.get("brief", {}).get("headline", ""),
"path": path.name,
"brief": payload.get("brief", {}),
}
)
return items
def load_brief_history_payloads(limit: int = 200) -> list[dict[str, Any]]:
history_dir = manager_brief_state_dir() / "history"
if not history_dir.exists():
return []
items: list[dict[str, Any]] = []
for path in sorted(history_dir.glob("*.json"), reverse=True)[:limit]:
payload = json.loads(path.read_text(encoding="utf-8"))
payload["_path"] = path.name
items.append(payload)
return items
def load_brief_history_record(name: str) -> dict[str, Any]:
safe_name = Path(name).name
if not safe_name.endswith(".json"):
safe_name += ".json"
path = manager_brief_state_dir() / "history" / safe_name
if not path.exists():
raise HTTPException(status_code=404, detail="manager brief history record not found")
return json.loads(path.read_text(encoding="utf-8"))
def extract_delta(payload: dict[str, Any]) -> dict[str, Any]:
delta = payload.get("context", {}).get("delta")
if isinstance(delta, dict):
return delta
return {"available": False, "reason": "delta not present in artifact"}
def priority_score_for_change(item: dict[str, Any]) -> float:
if item.get("priority_score") is not None:
try:
return float(item.get("priority_score"))
except (TypeError, ValueError):
return 0.0
score = 0.0
score += max(float(item.get("significance") or 0), 0)
score += max(float(item.get("score_delta") or 0), 0) * 0.8
score += max(float(item.get("open_cases_delta") or 0), 0) * 8
score += max(float(item.get("detections_delta") or 0), 0) * 5
score += max(float(item.get("active_locks_delta") or 0), 0) * 10
return round(score, 2)
def build_weekly_trend_report(payloads: list[dict[str, Any]], days: int = 7) -> dict[str, Any]:
now = datetime.now(UTC)
period_start = now.date().toordinal() - max(days - 1, 0)
filtered: list[dict[str, Any]] = []
for payload in payloads:
generated_at_raw = payload.get("generated_at")
if not generated_at_raw:
continue
try:
generated_at = datetime.fromisoformat(str(generated_at_raw))
except ValueError:
continue
if generated_at.tzinfo is None:
generated_at = generated_at.replace(tzinfo=UTC)
if generated_at.date().toordinal() < period_start:
continue
payload["_generated_dt"] = generated_at
filtered.append(payload)
by_day: dict[str, dict[str, Any]] = {}
for payload in filtered:
key = payload["_generated_dt"].date().isoformat()
previous = by_day.get(key)
if previous is None or payload["_generated_dt"] > previous["_generated_dt"]:
by_day[key] = payload
daily_rows: list[dict[str, Any]] = []
previous_summary: dict[str, Any] | None = None
for key in sorted(by_day.keys()):
payload = by_day[key]
summary = payload.get("context", {}).get("portfolio_summary", {})
row = {
"date": key,
"generated_at": payload.get("generated_at"),
"companies_total": int(summary.get("companies_total", 0) or 0),
"critical_total": int(summary.get("critical_total", 0) or 0),
"high_total": int(summary.get("high_total", 0) or 0),
"busy_total": int(summary.get("busy_total", 0) or 0),
"open_cases_total": int(summary.get("open_cases_total", 0) or 0),
"detections_total": int(summary.get("detections_total", 0) or 0),
"activity_30d_total": float(summary.get("activity_30d_total", 0) or 0),
"activity_forecast_30d_total": float(summary.get("activity_forecast_30d_total", 0) or 0),
}
if previous_summary:
row["critical_delta_vs_prev_day"] = row["critical_total"] - int(previous_summary.get("critical_total", 0) or 0)
row["busy_delta_vs_prev_day"] = row["busy_total"] - int(previous_summary.get("busy_total", 0) or 0)
row["open_cases_delta_vs_prev_day"] = row["open_cases_total"] - int(previous_summary.get("open_cases_total", 0) or 0)
row["detections_delta_vs_prev_day"] = row["detections_total"] - int(previous_summary.get("detections_total", 0) or 0)
else:
row["critical_delta_vs_prev_day"] = 0
row["busy_delta_vs_prev_day"] = 0
row["open_cases_delta_vs_prev_day"] = 0
row["detections_delta_vs_prev_day"] = 0
daily_rows.append(row)
previous_summary = summary
weekly_changes: dict[tuple[str, str], dict[str, Any]] = {}
for payload in filtered:
delta = extract_delta(payload)
for item in delta.get("top_changes", []):
key = (str(item.get("infobase") or ""), str(item.get("company") or ""))
candidate = dict(item)
candidate["generated_at"] = payload.get("generated_at")
candidate["priority_score"] = priority_score_for_change(candidate)
existing = weekly_changes.get(key)
if existing is None or float(candidate["priority_score"]) > float(existing.get("priority_score") or 0):
weekly_changes[key] = candidate
weekly_top_changes = sorted(
weekly_changes.values(),
key=lambda item: (
float(item.get("priority_score") or 0),
float(item.get("significance") or 0),
int(item.get("open_cases_delta") or 0),
),
reverse=True,
)[:20]
latest = daily_rows[-1] if daily_rows else None
return {
"days": days,
"period_start": datetime.fromordinal(period_start).date().isoformat(),
"period_end": now.date().isoformat(),
"daily": daily_rows,
"latest": latest,
"top_weekly_changes": weekly_top_changes,
}
def tier_rank(value: str | None) -> int:
return {
"low": 1,
"medium": 2,
"high": 3,
"critical": 4,
}.get((value or "low").lower(), 1)
def find_change_for_company(
items: list[dict[str, Any]],
counterparty: str,
infobase: str | None = None,
) -> dict[str, Any] | None:
fallback: dict[str, Any] | None = None
for item in items:
if str(item.get("company") or "") != counterparty:
continue
if infobase and str(item.get("infobase") or "") == infobase:
return item
if fallback is None:
fallback = item
return fallback
def build_company_priority_context(summary_payload: dict[str, Any], infobase: str | None = None) -> dict[str, Any]:
card = summary_payload.get("card") or {}
counterparty = str(card.get("counterparty") or "")
current_infobase = infobase or str(card.get("infobase") or "")
latest_change = None
weekly_change = None
weekly_report = {"top_weekly_changes": []}
try:
latest_brief = load_latest_manager_brief()
latest_change = find_change_for_company(
extract_delta(latest_brief).get("top_changes", []),
counterparty,
current_infobase or None,
)
except HTTPException:
latest_brief = None
try:
weekly_report = build_weekly_trend_report(load_brief_history_payloads(limit=400), days=7)
weekly_change = find_change_for_company(
weekly_report.get("top_weekly_changes", []),
counterparty,
current_infobase or None,
)
except Exception:
weekly_report = {"top_weekly_changes": []}
current_tier = "low"
current_score = 0.0
current_reason = "сильных weekly/delta-триггеров не видно"
if latest_change:
current_tier = str(latest_change.get("priority_tier") or "low")
current_score = float(latest_change.get("priority_score") or 0)
current_reason = str(latest_change.get("priority_reason") or latest_change.get("summary") or current_reason)
elif weekly_change:
current_tier = str(weekly_change.get("priority_tier") or "low")
current_score = float(weekly_change.get("priority_score") or 0)
current_reason = str(weekly_change.get("priority_reason") or weekly_change.get("summary") or current_reason)
else:
severity = str(card.get("signal_severity") or "low")
current_tier = severity if severity in {"critical", "high", "medium", "low"} else "low"
current_score = float(card.get("signal_score") or 0)
if int(card.get("open_cases_total") or 0) > 0 or int(card.get("active_locks") or 0) > 0:
current_reason = "у компании уже есть operational pressure: кейсы/блокировки/сигналы"
evidence: list[str] = []
actions: list[str] = []
if latest_change:
evidence.append(f"Последний запуск: {latest_change.get('summary') or current_reason}")
if int(latest_change.get("open_cases_delta") or 0) > 0:
evidence.append(f"Кейсы выросли на +{int(latest_change.get('open_cases_delta') or 0)}.")
actions.append("Сразу разобрать новые открытые кейсы по компании.")
if int(latest_change.get("detections_delta") or 0) > 0:
evidence.append(f"Detections выросли на +{int(latest_change.get('detections_delta') or 0)}.")
if int(latest_change.get("active_locks_delta") or 0) > 0:
evidence.append(f"Блокировки выросли на +{int(latest_change.get('active_locks_delta') or 0)}.")
actions.append("Проверить, не застряла ли файловая база в busy/lock-контуре.")
if float(latest_change.get("forecast_delta") or 0) < 0:
evidence.append(f"Прогноз 30д просел на {fmt_number(latest_change.get('forecast_delta'))}.")
if weekly_change and weekly_change is not latest_change:
evidence.append(f"За неделю компания вошла в top changes: {weekly_change.get('priority_reason') or weekly_change.get('summary')}.")
if str(card.get("signal_severity") or "none") in {"critical", "high"}:
evidence.append(f"Текущая severity {card.get('signal_severity')} при score {fmt_number(card.get('signal_score'))}.")
if card.get("registry_match_mode") == "manual":
evidence.append("Привязка к реестру manual: интерпретацию владельца и юр. соответствия проверять отдельно.")
if int(card.get("open_cases_total") or 0) > 0:
evidence.append(f"Сейчас открытых кейсов {int(card.get('open_cases_total') or 0)}.")
if int(card.get("detections_total") or 0) > 0:
evidence.append(f"Сейчас active detections {int(card.get('detections_total') or 0)}.")
if int(card.get("active_locks") or 0) > 0:
evidence.append(f"Сейчас активных блокировок {int(card.get('active_locks') or 0)}.")
if int(card.get("days_since_last_activity") or 0) >= 7:
evidence.append(f"Компания молчит уже {int(card.get('days_since_last_activity') or 0)} дн.")
actions.append("Подтвердить, это плановая бизнес-пауза или выпадение из операционного ритма.")
if not actions:
actions.append("Сначала проверить последние сигналы и timeline компании, затем подтверждать бизнес-выводы.")
if int(card.get("open_cases_total") or 0) > 0 and "Сразу разобрать новые открытые кейсы по компании." not in actions:
actions.append("Разобрать открытые кейсы до обсуждения прогноза.")
if int(card.get("active_locks") or 0) > 0 and "Проверить, не застряла ли файловая база в busy/lock-контуре." not in actions:
actions.append("Проверить busy/lock-контур файловой базы.")
if tier_rank(current_tier) >= tier_rank("high"):
verdict = (
"Приоритет действительно высокий не из-за общей красноты портфеля, а из-за конкретных operational-сдвигов по этой компании."
)
elif tier_rank(current_tier) == tier_rank("medium"):
verdict = "Приоритет средний: явный сдвиг есть, но он ещё не выглядит аварийным."
else:
verdict = "Приоритет низкий: компания видна в портфеле, но жёсткого триггера на разбор первой очереди нет."
return {
"current_priority_tier": current_tier,
"current_priority_score": round(current_score, 2),
"current_priority_reason": current_reason,
"latest_change": latest_change,
"weekly_change": weekly_change,
"weekly_period_start": weekly_report.get("period_start"),
"weekly_period_end": weekly_report.get("period_end"),
"verdict": verdict,
"evidence": evidence[:8],
"actions": actions[:5],
}
def find_recovery_incident_for_company(
items: list[dict[str, Any]],
counterparty: str,
infobase: str | None = None,
) -> dict[str, Any] | None:
fallback: dict[str, Any] | None = None
for item in items:
if str(item.get("company") or "") != counterparty:
continue
if infobase and str(item.get("infobase") or "") == infobase:
return item
if fallback is None:
fallback = item
return fallback
def build_company_recovery_context(summary_payload: dict[str, Any], infobase: str | None = None) -> dict[str, Any]:
card = summary_payload.get("card") or {}
priority_context = summary_payload.get("priority_context") or build_company_priority_context(summary_payload, infobase)
counterparty = str(card.get("counterparty") or "")
matched_incident = None
recovery_generated_at = None
try:
recovery_payload = load_latest_recovery_brief()
matched_incident = find_recovery_incident_for_company(
recovery_payload.get("recovery", {}).get("top_incidents", []),
counterparty,
infobase or str(card.get("infobase") or "") or None,
)
recovery_generated_at = recovery_payload.get("generated_at")
except HTTPException:
recovery_payload = None
if matched_incident:
diagnosis = str(matched_incident.get("diagnosis") or priority_context.get("current_priority_reason") or "-")
actions = [str(item) for item in matched_incident.get("actions", []) if str(item).strip()]
stop_doing = str(matched_incident.get("stop_doing") or "")
target_state = str(matched_incident.get("target_state_24h") or "")
confidence = "recovery-brief/codex"
else:
diagnosis_parts = [str(priority_context.get("current_priority_reason") or "").strip()]
if int(card.get("open_cases_total") or 0) > 0:
diagnosis_parts.append(f"открытых кейсов {int(card.get('open_cases_total') or 0)}")
if int(card.get("active_locks") or 0) > 0:
diagnosis_parts.append(f"активных блокировок {int(card.get('active_locks') or 0)}")
if int(card.get("detections_total") or 0) > 0:
diagnosis_parts.append(f"detections {int(card.get('detections_total') or 0)}")
diagnosis = "; ".join(part for part in diagnosis_parts if part) or "явного recovery-диагноза пока нет"
actions = list(priority_context.get("actions", []))
if int(card.get("open_cases_total") or 0) > 0 and "Назначить владельца на закрытие открытых кейсов в течение 24 часов." not in actions:
actions.insert(0, "Назначить владельца на закрытие открытых кейсов в течение 24 часов.")
if int(card.get("active_locks") or 0) > 0 and "Снять busy/lock-контур прежде чем обсуждать долгосрочный прогноз." not in actions:
actions.append("Снять busy/lock-контур прежде чем обсуждать долгосрочный прогноз.")
if card.get("registry_match_mode") == "manual" and "Проверить корректность manual-сопоставления до жёстких управленческих выводов." not in actions:
actions.append("Проверить корректность manual-сопоставления до жёстких управленческих выводов.")
stop_doing = "Не проводить общие обсуждения без владельца, срока и числовой цели на день."
target_cases = max(int(card.get("open_cases_total") or 0) - 3, 0)
target_state = (
f"Снизить открытые кейсы ниже {target_cases}, "
f"снять новый прирост и подтвердить отсутствие лишних блокировок по следующему запуску."
)
confidence = "deterministic-fallback"
return {
"generated_at": recovery_generated_at,
"confidence": confidence,
"diagnosis": diagnosis,
"actions": actions[:5],
"stop_doing": stop_doing,
"target_state_24h": target_state,
"source_incident": matched_incident,
}
def grafana_company_dashboard_url() -> str:
return os.getenv(
"AW_1C_MANAGER_BRIEF_GRAFANA_URL",
"http://192.0.2.11:3000/d/1c-file-mgmt/1c-file-management-board",
)
def resolve_company_portfolio_card(company_ref: str, infobase: str | None = None) -> dict[str, Any]:
client = ch_client()
filters = [
"("
+ " OR ".join(
[
f"company_entity_key = {q(company_ref)}",
f"counterparty = {q(company_ref)}",
f"company_name = {q(company_ref)}",
f"source_counterparty = {q(company_ref)}",
]
)
+ ")"
]
if infobase:
filters.append(f"infobase = {q(infobase)}")
sql = f"""
SELECT *
FROM analytics_1c.v_company_portfolio_overview
WHERE {' AND '.join(filters)}
ORDER BY last_company_snapshot_at DESC, amount_30d DESC
LIMIT 1
"""
rows = rows_to_dict(client.query(sql))
if not rows:
raise HTTPException(status_code=404, detail="company not found in analytics_1c.v_company_portfolio_overview")
return rows[0]
def fmt_number(value: Any) -> str:
if value is None or value == "":
return "-"
if isinstance(value, float):
return f"{value:,.2f}".replace(",", " ").replace(".", ",")
if isinstance(value, int):
return f"{value:,}".replace(",", " ")
return str(value)
def severity_badge(severity: str) -> str:
tone = {
"critical": "critical",
"high": "high",
"medium": "medium",
"low": "low",
"none": "none",
}.get((severity or "").lower(), "none")
return f'{html.escape(severity or "none")}'
def company_detail_url(company_ref: str, infobase: str | None = None) -> str:
base = f"/manager/company/{quote(company_ref)}"
if infobase:
return f"{base}?infobase={quote(infobase)}"
return base
def manager_brief_history_html_url(name: str) -> str:
safe_name = Path(name).name
return f"/manager/briefs/{quote(safe_name)}"
def render_manager_brief_html(payload: dict[str, Any]) -> str:
brief = payload.get("brief", {})
context = payload.get("context", {})
summary = context.get("portfolio_summary", {})
freshness = context.get("freshness", [])
manager_questions = brief.get("manager_questions", [])
management_plan = brief.get("management_plan", [])
top_risks = brief.get("top_risks", [])
top_forecasts = brief.get("top_forecasts", [])
actions = brief.get("actions", [])
caveats = brief.get("caveats", [])
render_mode = payload.get("render_mode", "unknown")
generated_at = payload.get("generated_at", "")
history_url = "/api/1/analytics-1c/manager/brief/history"
history_html_url = "/manager/briefs"
delta_html_url = "/manager/changes"
weekly_html_url = "/manager/trends/weekly"
weekly_digest_url = "/manager/digest/weekly"
recovery_html_url = "/manager/recovery"
actions_html_url = "/manager/actions"
problematic_1d_url = "/manager/problematic?days=1"
problematic_7d_url = "/manager/problematic?days=7"
json_url = "/api/1/analytics-1c/manager/brief/latest"
md_url = "/api/1/analytics-1c/manager/brief/latest.md"
grafana_url = grafana_company_dashboard_url()
freshness_rows = []
for item in freshness:
status = "stale" if item.get("stale") else "fresh"
freshness_rows.append(
"
"
f"| {html.escape(str(item.get('source', '')))} | "
f"{html.escape(str(item.get('latest_ts', '-')))} | "
f"{html.escape(str(item.get('lag_hours', '-')))} | "
f"{'просрочен' if status == 'stale' else 'свежий'} | "
"
"
)
risk_cards = []
for item in top_risks:
risk_cards.append(
""
f"{html.escape(item.get('company', '-'))}
{severity_badge(item.get('severity', ''))}"
f"{html.escape(item.get('reason', '-'))}
"
f"Действие: {html.escape(item.get('recommended_action', '-'))}
"
f"Открыть карточку компании
"
""
)
forecast_cards = []
for item in top_forecasts:
company = item.get("company", "-")
forecast_cards.append(
""
f"{html.escape(company)}
"
f"Прогноз 30д: {html.escape(item.get('forecast_30d', '-'))}
"
f"{html.escape(item.get('interpretation', '-'))}
"
f"Карточка компании"
""
)
question_cards = []
for item in manager_questions:
question_cards.append(
""
f"{html.escape(item.get('question', '-'))}
"
f"{html.escape(item.get('answer', '-'))}
"
f"Рекомендация: {html.escape(item.get('recommended_action', '-'))}
"
""
)
horizon_label = {"today": "Сегодня", "week": "Неделя", "30d": "30 дней"}
plan_cards = []
for item in management_plan:
plan_cards.append(
""
f"{html.escape(item.get('focus', '-'))}
{html.escape(horizon_label.get(str(item.get('horizon')), str(item.get('horizon', '-'))))}"
f"Действие: {html.escape(item.get('action', '-'))}
"
f"Ожидаемый эффект: {html.escape(item.get('expected_effect', '-'))}
"
f"Метрика: {html.escape(item.get('metric', '-'))}
"
""
)
summary_items = "\n".join(f"{html.escape(str(item))}" for item in brief.get("summary", []))
action_items = "\n".join(f"{html.escape(str(item))}" for item in actions)
caveat_items = "\n".join(f"{html.escape(str(item))}" for item in caveats)
morning_regulation_items = "\n".join(
f"{html.escape(str(item))}"
for item in [
"Открыть brief, changes и weekly digest. Сначала понять: хвост кейсов растёт или сокращается.",
"Выбрать не больше 5 компаний первой очереди. Критерии: рост open cases, active locks, manual-match, повторный critical без улучшения.",
"По каждой компании требовать только 4 вещи: причина, владелец, срок, измеримый результат к вечеру.",
"Не принимать формулировки «смотрим», «разбираемся», «в работе». Принимать только конкретный план закрытия.",
]
)
evening_regulation_items = "\n".join(
f"{html.escape(str(item))}"
for item in [
"По каждой компании дня спросить только факт: сколько кейсов было утром и сколько стало вечером.",
"Отдельно проверить, снялись ли блокировки и исчез ли прирост новых кейсов.",
"По каждой компании зафиксировать один статус: снято, частично снято, не снято.",
"Если результата нет, менять владельца или усиливать контроль; не переносить хвост молча.",
]
)
hard_rules_items = "\n".join(
f"{html.escape(str(item))}"
for item in [
"Не пытаться разбирать все 41 компании сразу.",
"Не путать operational critical с финансовым крахом портфеля.",
"Не делать жёстких оргвыводов по manual-match компаниям без проверки соответствия реестру.",
"Главный KPI на сейчас: закрытые кейсы и снятые блокировки, а не количество проведённых разборов.",
]
)
return f"""
1C Executive Brief
Краткий комментарий
{summary_items}
Портфель
Компаний
{fmt_number(summary.get("companies_total"))}
Critical
{fmt_number(summary.get("critical_total"))}
Кейсы
{fmt_number(summary.get("open_cases_total"))}
Прогноз 30д
{fmt_number(summary.get("activity_forecast_30d_total"))}
Простые ответы для руководителя
{''.join(question_cards) or '
Нет данных.
'}
План действий руководителя
{''.join(plan_cards) or '
Нет данных.
'}
Компании риска
{''.join(risk_cards) or '
Нет данных.
'}
Прогноз активности 30 дней
{''.join(forecast_cards) or '
Нет данных.
'}
Что проверить руководителю
Ограничения интерпретации
Регламент руководителя: утро
{morning_regulation_items}
Регламент руководителя: вечер
{evening_regulation_items}
Жёсткие правила управления
Свежесть источников
| Источник |
Последняя отметка |
Отставание, ч |
Статус |
{''.join(freshness_rows)}
"""
def problematic_companies(days: int = 7, limit: int = 50) -> list[dict[str, Any]]:
client = ch_client()
sql = f"""
WITH recent AS (
SELECT
infobase,
counterparty AS company_entity_key,
max(generated_at) AS latest_signal_at,
max(score) AS max_score,
sum(score) AS total_score,
count() AS signals_total,
countIf(severity = 'critical') AS critical_total,
countIf(severity = 'high') AS high_total,
argMax(severity, tuple(score, generated_at)) AS top_severity,
argMax(signal_type, tuple(score, generated_at)) AS top_signal_type,
argMax(summary, tuple(score, generated_at)) AS top_summary
FROM analytics_1c.company_health_signals
WHERE generated_at >= now() - INTERVAL {int(days)} DAY
GROUP BY infobase, counterparty
)
SELECT
p.infobase AS infobase,
p.company_entity_key AS company_entity_key,
p.counterparty AS counterparty,
p.source_counterparty,
p.company_name,
p.normalized_counterparty,
p.registry_match_mode,
p.registry_assignee_name,
p.registry_status,
p.signal_severity,
p.signal_score,
p.amount_30d,
p.amount_forecast_30d,
p.current_status,
p.active_locks,
p.open_cases_total,
p.detections_total,
r.latest_signal_at,
r.max_score,
r.total_score,
r.signals_total,
r.critical_total,
r.high_total,
r.top_severity,
r.top_signal_type,
r.top_summary
FROM recent AS r
INNER JOIN analytics_1c.v_company_portfolio_overview AS p
ON p.infobase = r.infobase
AND p.company_entity_key = r.company_entity_key
ORDER BY r.max_score DESC, r.signals_total DESC, p.amount_30d DESC, p.counterparty
LIMIT {int(limit)}
"""
items = rows_to_dict(client.query(sql))
for item in items:
if "infobase" not in item and "p.infobase" in item:
item["infobase"] = item["p.infobase"]
if "counterparty" not in item and "p.counterparty" in item:
item["counterparty"] = item["p.counterparty"]
return items
def management_actions(
priority_tier: str | None = None,
owner: str | None = None,
limit: int = 100,
) -> list[dict[str, Any]]:
client = ch_client()
where: list[str] = []
if priority_tier:
where.append(f"priority_tier = {q(priority_tier)}")
if owner:
where.append(f"owner_name = {q(owner)}")
sql = f"""
SELECT
generated_at,
action_id,
infobase,
company_entity_key,
counterparty,
company_name,
organization,
owner_name,
action_type,
priority_tier,
priority_score,
priority_rank,
deadline_hint,
reason,
recommended_action,
evidence_summary,
open_cases_total,
detections_total,
active_locks,
days_since_last_activity,
risky_changes_24h,
large_adjustments_24h,
max_large_adjustment_amount,
last_seen_at
FROM analytics_1c.v_company_management_actions_current
{"WHERE " + " AND ".join(where) if where else ""}
ORDER BY priority_rank DESC, priority_score DESC, counterparty, action_type
LIMIT {int(limit)}
"""
return rows_to_dict(client.query(sql))
def management_company_actions(
priority_tier: str | None = None,
owner: str | None = None,
limit: int = 100,
) -> list[dict[str, Any]]:
client = ch_client()
where: list[str] = []
if priority_tier:
where.append(f"priority_tier = {q(priority_tier)}")
if owner:
where.append(f"owner_names ILIKE {q('%' + owner + '%')}")
sql = f"""
SELECT
generated_at,
infobase,
company_entity_key,
counterparty,
company_name,
organization,
owner_names,
priority_tier,
priority_rank,
priority_score,
actions_total,
critical_actions_total,
high_actions_total,
medium_actions_total,
low_actions_total,
action_types_summary,
recommended_action_summary,
reason_summary,
evidence_summary,
open_cases_total,
detections_total,
active_locks,
days_since_last_activity,
risky_changes_24h,
large_adjustments_24h,
max_large_adjustment_amount,
last_seen_at
FROM analytics_1c.v_company_management_companies_current
{"WHERE " + " AND ".join(where) if where else ""}
ORDER BY priority_rank DESC, priority_score DESC, counterparty
LIMIT {int(limit)}
"""
return rows_to_dict(client.query(sql))
def company_management_actions(company_ref: str, infobase: str | None = None, limit: int = 20) -> list[dict[str, Any]]:
client = ch_client()
card = resolve_company_portfolio_card(company_ref, infobase)
filters = [f"company_entity_key = {q(str(card.get('company_entity_key') or company_ref))}"]
if card.get("infobase") or infobase:
filters.append(f"infobase = {q(str(card.get('infobase') or infobase))}")
sql = f"""
SELECT
generated_at,
action_id,
infobase,
company_entity_key,
counterparty,
company_name,
organization,
owner_name,
action_type,
priority_tier,
priority_score,
priority_rank,
deadline_hint,
reason,
recommended_action,
evidence_summary,
open_cases_total,
detections_total,
active_locks,
days_since_last_activity,
risky_changes_24h,
large_adjustments_24h,
max_large_adjustment_amount,
last_seen_at
FROM analytics_1c.v_company_management_actions_current
WHERE {' AND '.join(filters)}
ORDER BY priority_rank DESC, priority_score DESC, action_type
LIMIT {int(limit)}
"""
return rows_to_dict(client.query(sql))
def _actions_query_suffix(priority_tier: str | None = None, owner: str | None = None) -> str:
parts: list[str] = []
if priority_tier:
parts.append(f"priority_tier={quote(priority_tier)}")
if owner:
parts.append(f"owner={quote(owner)}")
return ("?" + "&".join(parts)) if parts else ""
def render_brief_history_html(items: list[dict[str, Any]]) -> str:
rows = []
for item in items:
rows.append(
""
f"| {html.escape(str(item.get('generated_at', '-')))} | "
f"{html.escape(str(item.get('render_mode', '-')))} | "
f"{html.escape(str(item.get('model') or '-'))} | "
f"{html.escape(str(item.get('headline') or '-'))} | "
f"Изменения | "
f"JSON | "
"
"
)
return f"""
1C Brief History
| Сформировано |
Режим |
Модель |
Headline |
Delta |
Raw |
{''.join(rows) or '| История пока пуста. |
'}
"""
def render_problematic_companies_html(items: list[dict[str, Any]], days: int) -> str:
rows = []
for item in items:
rows.append(
""
f"| {html.escape(str(item.get('counterparty', '-')))} | "
f"{html.escape(str(item.get('normalized_counterparty') or '-'))} | "
f"{severity_badge(str(item.get('top_severity') or item.get('signal_severity') or 'none'))} | "
f"{fmt_number(item.get('max_score'))} | "
f"{fmt_number(item.get('signals_total'))} | "
f"{fmt_number(item.get('critical_total'))} | "
f"{fmt_number(item.get('amount_30d'))} | "
f"{fmt_number(item.get('amount_forecast_30d'))} | "
f"{html.escape(str(item.get('top_signal_type') or '-'))} | "
f"{html.escape(str(item.get('top_summary') or '-'))} | "
"
"
)
return f"""
1C Problem Companies
Проблемные компании за {days} {('день' if days == 1 else 'дней')}
Список собран по live company signals. В приоритете max score, плотность сигналов и общий вес проблемного контура.
| Компания |
Нормализация |
Severity |
Max score |
Signals |
Critical |
Активность 30д |
Прогноз 30д |
Top signal |
Комментарий |
{''.join(rows) or '| Нет сигналов за выбранный период. |
'}
"""
def render_management_actions_html(
items: list[dict[str, Any]],
companies: list[dict[str, Any]],
priority_tier: str | None = None,
owner: str | None = None,
) -> str:
rows = []
counts = {"critical": 0, "high": 0, "medium": 0, "low": 0}
owners: dict[str, int] = {}
for item in items:
tier = str(item.get("priority_tier") or "low").lower()
if tier in counts:
counts[tier] += 1
owner_name = str(item.get("owner_name") or "не назначен")
owners[owner_name] = owners.get(owner_name, 0) + 1
rows.append(
""
f"| {severity_badge(str(item.get('priority_tier') or 'low'))} | "
f"{html.escape(str(item.get('deadline_hint') or '-'))} | "
f"{html.escape(str(item.get('counterparty') or '-'))} | "
f"{html.escape(owner_name)} | "
f"{html.escape(str(item.get('action_type') or '-'))} | "
f"{html.escape(fmt_number(item.get('priority_score')))} | "
f"{html.escape(str(item.get('recommended_action') or '-'))} | "
f"{html.escape(str(item.get('reason') or '-'))} | "
f"{html.escape(str(item.get('evidence_summary') or '-'))} | "
"
"
)
company_rows = []
companies_critical = 0
companies_unassigned = 0
for item in companies:
tier = str(item.get("priority_tier") or "low").lower()
if tier == "critical":
companies_critical += 1
owner_names = str(item.get("owner_names") or "не назначен")
if owner_names == "не назначен":
companies_unassigned += 1
company_rows.append(
""
f"| {severity_badge(tier)} | "
f"{html.escape(str(item.get('counterparty') or '-'))} | "
f"{html.escape(fmt_number(item.get('actions_total')))} | "
f"{html.escape(str(item.get('action_types_summary') or '-'))} | "
f"{html.escape(str(item.get('recommended_action_summary') or '-'))} | "
f"{html.escape(str(item.get('reason_summary') or '-'))} | "
f"{html.escape(owner_names)} | "
"
"
)
top_owners = sorted(owners.items(), key=lambda pair: (-pair[1], pair[0]))[:5]
owner_items = "".join(
f"{html.escape(name)}: {html.escape(fmt_number(total))} действий"
for name, total in top_owners
)
filters: list[str] = []
if priority_tier:
filters.append(f"priority_tier={priority_tier}")
if owner:
filters.append(f"owner={owner}")
filter_line = ", ".join(filters) if filters else "без фильтра"
query_suffix = _actions_query_suffix(priority_tier=priority_tier, owner=owner)
raw_json_url = f"/api/1/analytics-1c/manager/actions{query_suffix}"
companies_json_url = f"/api/1/analytics-1c/manager/actions/companies{query_suffix}"
return f"""
1C Manager Actions
Очередь управленческих действий по 1С
Детерминированный слой поверх portfolio/signals/business events/document changes. Фильтр: {html.escape(filter_line)}.
Приоритет считается по риску предприятия. Текущее назначение используется только как operational metadata и не меняет порядок очереди.
Срез очереди
Всего действий
{html.escape(fmt_number(len(items)))}
Предприятий
{html.escape(fmt_number(len(companies)))}
Critical предприятий
{html.escape(fmt_number(companies_critical))}
Без владельца
{html.escape(fmt_number(companies_unassigned))}
Текущее назначение
{owner_items or '- Нет назначенных действий.
'}
Что делать по предприятиям
| Приоритет |
Предприятие |
Действий |
Контур |
Что сделать |
Почему |
Текущее назначение |
{''.join(company_rows) or '| Нет компаний с активными действиями. |
'}
Детализация действий
| Приоритет |
Срок |
Компания |
Ответственный |
Тип |
Score |
Действие |
Почему |
Evidence |
{''.join(rows) or '| Действий не найдено. |
'}
"""
def render_brief_delta_html(payload: dict[str, Any]) -> str:
delta = extract_delta(payload)
brief = payload.get("brief", {})
if not delta.get("available"):
return f"""
1C Brief Changes
Что изменилось с прошлого запуска
Delta пока недоступна: {html.escape(str(delta.get('reason', 'unknown')))}.
Вернуться к brief
"""
summary = delta.get("summary", {})
top_changes = delta.get("top_changes", [])
new_critical = delta.get("new_critical", [])
resolved_critical = delta.get("resolved_critical", [])
entered_watchlist = delta.get("entered_watchlist", [])
left_watchlist = delta.get("left_watchlist", [])
def delta_value(value: Any) -> str:
try:
numeric = float(value)
except (TypeError, ValueError):
return html.escape(str(value))
prefix = "+" if numeric > 0 else ""
if numeric.is_integer():
return prefix + str(int(numeric))
return prefix + f"{numeric:.2f}".replace(".", ",")
stat_cards = [
("Critical", delta_value(summary.get("critical_total_delta", 0))),
("Busy", delta_value(summary.get("busy_total_delta", 0))),
("Кейсы", delta_value(summary.get("open_cases_total_delta", 0))),
("Detections", delta_value(summary.get("detections_total_delta", 0))),
("Активность 30д", delta_value(summary.get("activity_30d_total_delta", 0))),
("Прогноз 30д", delta_value(summary.get("activity_forecast_30d_total_delta", 0))),
]
stat_html = "".join(
f"{html.escape(label)}
{html.escape(value)}
"
for label, value in stat_cards
)
tier_labels = {
"critical": "Критический",
"high": "Высокий",
"medium": "Средний",
"low": "Низкий",
}
rows = []
for item in top_changes:
infobase = item.get("infobase")
counterparty = item.get("company")
priority_tier = str(item.get("priority_tier") or "low")
rows.append(
""
f"| {html.escape(str(counterparty or '-'))} | "
f"{html.escape(tier_labels.get(priority_tier, priority_tier))} | "
f"{delta_value(item.get('priority_score', 0))} | "
f"{html.escape(str(item.get('change_type') or '-'))} | "
f"{html.escape(str(item.get('severity_before') or '-'))} -> {html.escape(str(item.get('severity_after') or '-'))} | "
f"{delta_value(item.get('score_delta', 0))} | "
f"{delta_value(item.get('open_cases_delta', 0))} | "
f"{delta_value(item.get('active_locks_delta', 0))} | "
f"{delta_value(item.get('forecast_delta', 0))} | "
f"{html.escape(str(item.get('priority_reason') or '-'))} | "
f"{html.escape(str(item.get('summary') or '-'))} | "
"
"
)
def as_list(items: list[str]) -> str:
if not items:
return "Нет"
return "".join(f"{html.escape(str(item))}" for item in items)
return f"""
1C Brief Changes
Что изменилось с прошлого запуска
Сравнение запусков: {html.escape(str(delta.get('previous_generated_at') or '-'))} -> {html.escape(str(delta.get('current_generated_at') or payload.get('generated_at') or '-'))}.
Сводка изменений
{stat_html}
Новые critical
Вышли из critical
{as_list(resolved_critical)}
Зашли в watchlist
{as_list(entered_watchlist)}
Вышли из watchlist
{as_list(left_watchlist)}
Ключевые изменения
| Компания |
Приоритет |
Score |
Тип |
Severity |
Score Δ |
Cases Δ |
Locks Δ |
Forecast Δ |
Причина приоритета |
Комментарий |
{''.join(rows) or '| Нет выраженных изменений. |
'}
"""
def render_weekly_trend_html(report: dict[str, Any]) -> str:
daily = report.get("daily", [])
latest = report.get("latest") or {}
top_weekly_changes = report.get("top_weekly_changes", [])
def value(v: Any) -> str:
return fmt_number(v)
trend_rows = []
for item in daily:
trend_rows.append(
""
f"| {html.escape(str(item.get('date', '-')))} | "
f"{value(item.get('companies_total'))} | "
f"{value(item.get('critical_total'))} | "
f"{value(item.get('busy_total'))} | "
f"{value(item.get('open_cases_total'))} | "
f"{value(item.get('detections_total'))} | "
f"{value(item.get('activity_30d_total'))} | "
f"{value(item.get('activity_forecast_30d_total'))} | "
f"{value(item.get('critical_delta_vs_prev_day'))} | "
f"{value(item.get('open_cases_delta_vs_prev_day'))} | "
"
"
)
change_rows = []
for item in top_weekly_changes:
infobase = item.get("infobase")
company = item.get("company")
change_rows.append(
""
f"| {html.escape(str(company or '-'))} | "
f"{html.escape(str(item.get('priority_tier') or '-'))} | "
f"{value(item.get('priority_score'))} | "
f"{html.escape(str(item.get('change_type') or '-'))} | "
f"{value(item.get('open_cases_delta'))} | "
f"{value(item.get('active_locks_delta'))} | "
f"{value(item.get('forecast_delta'))} | "
f"{html.escape(str(item.get('priority_reason') or '-'))} | "
"
"
)
stat_cards = [
("Компаний", value(latest.get("companies_total"))),
("Critical", value(latest.get("critical_total"))),
("Busy", value(latest.get("busy_total"))),
("Кейсы", value(latest.get("open_cases_total"))),
("Detections", value(latest.get("detections_total"))),
("Прогноз 30д", value(latest.get("activity_forecast_30d_total"))),
]
stat_html = "".join(
f"{html.escape(label)}
{html.escape(val)}
"
for label, val in stat_cards
)
return f"""
1C Weekly Trends
Недельный тренд портфеля
Период: {html.escape(str(report.get('period_start', '-')))} -> {html.escape(str(report.get('period_end', '-')))}. Страница показывает тренд по истории executive brief и недельный рейтинг проблемных компаний.
Текущее состояние по последнему дневному срезу
{stat_html}
Дневной тренд
| Дата |
Компаний |
Critical |
Busy |
Кейсы |
Detections |
Активность 30д |
Прогноз 30д |
Critical Δ |
Cases Δ |
{''.join(trend_rows) or '| Недостаточно истории для недельного тренда. |
'}
Недельный рейтинг приоритетов
| Компания |
Приоритет |
Priority score |
Тип |
Cases Δ |
Locks Δ |
Forecast Δ |
Причина |
{''.join(change_rows) or '| За выбранный период заметных изменений нет. |
'}
"""
def render_weekly_digest_html(payload: dict[str, Any]) -> str:
digest = payload.get("digest", {})
context = payload.get("context", {})
latest = context.get("latest_summary", {})
top_priorities = digest.get("top_priorities", [])
improvements = digest.get("improvements", [])
actions = digest.get("actions", [])
caveats = digest.get("caveats", [])
summary = digest.get("summary", [])
generated_at = payload.get("generated_at", "")
stat_cards = [
("Компаний", fmt_number(latest.get("companies_total"))),
("Critical", fmt_number(latest.get("critical_total"))),
("Busy", fmt_number(latest.get("busy_total"))),
("Кейсы", fmt_number(latest.get("open_cases_total"))),
("Detections", fmt_number(latest.get("detections_total"))),
("Прогноз 30д", fmt_number(latest.get("activity_forecast_30d_total"))),
]
stat_html = "".join(
f"{html.escape(label)}
{html.escape(value)}
"
for label, value in stat_cards
)
priority_cards = []
for item in top_priorities:
company = str(item.get("company") or "-")
priority_cards.append(
""
f"{html.escape(company)}
{severity_badge(str(item.get('priority') or 'low'))}"
f"{html.escape(str(item.get('reason') or '-'))}
"
f"Действие: {html.escape(str(item.get('recommended_action') or '-'))}
"
f"Карточка компании
"
""
)
improvement_rows = []
for item in improvements:
improvement_rows.append(
""
f"| {html.escape(str(item.get('company') or '-'))} | "
f"{html.escape(str(item.get('signal') or '-'))} | "
f"{html.escape(str(item.get('meaning') or '-'))} | "
"
"
)
summary_items = "\n".join(f"{html.escape(str(item))}" for item in summary)
action_items = "\n".join(f"{html.escape(str(item))}" for item in actions)
caveat_items = "\n".join(f"{html.escape(str(item))}" for item in caveats)
return f"""
1C Weekly Digest
{html.escape(str(digest.get('headline') or 'Weekly digest'))}
Период: {html.escape(str(context.get('period_start') or '-'))} -> {html.escape(str(context.get('period_end') or '-'))}. Сформировано: {html.escape(str(generated_at or '-'))}.
Кратко для руководителя
Срез недели
{stat_html}
Компании первой очереди
{''.join(priority_cards) or '
Нет weekly priorities.
'}
Что делать
Что улучшилось за неделю
| Компания | Сигнал | Что это значит |
{''.join(improvement_rows) or '| Явных улучшений за неделю не зафиксировано. |
'}
Ограничения интерпретации
"""
def render_recovery_brief_html(payload: dict[str, Any]) -> str:
recovery = payload.get("recovery", {})
generated_at = payload.get("generated_at", "")
render_mode = payload.get("render_mode", "unknown")
situation_items = "".join(f"{html.escape(str(item))}" for item in recovery.get("situation", []))
action_items = "".join(f"{html.escape(str(item))}" for item in recovery.get("portfolio_actions", []))
caveat_items = "".join(f"{html.escape(str(item))}" for item in recovery.get("caveats", []))
incident_cards = []
for item in recovery.get("top_incidents", []):
company = str(item.get("company") or "-")
actions = "".join(f"{html.escape(str(action))}" for action in item.get("actions", []))
incident_cards.append(
""
f"{html.escape(company)}
{severity_badge(str(item.get('severity') or 'critical'))}"
f"Диагноз: {html.escape(str(item.get('diagnosis') or '-'))}
"
f"Что не делать: {html.escape(str(item.get('stop_doing') or '-'))}
"
f"Цель 24ч: {html.escape(str(item.get('target_state_24h') or '-'))}
"
f""
f"Карточка компании
"
""
)
return f"""
1C Recovery Brief
Ситуация
Что делать по портфелю
Компании первой очереди для recovery
{''.join(incident_cards) or '
Нет recovery-инцидентов.
'}
Ограничения интерпретации
"""
app = FastAPI(title="AW-rus 1C Company Intelligence API", version="1.0.0")
@app.get("/")
def root() -> Response:
return Response(status_code=307, headers={"Location": "/manager/brief"})
@app.get("/favicon.ico")
def favicon() -> Response:
return Response(status_code=204)
@app.get("/health")
def health() -> dict[str, Any]:
client = ch_client()
summary = rows_to_dict(
client.query(
"""
SELECT
countIf(counterparty != '') AS documents_with_counterparty,
(SELECT count() FROM analytics_1c.companies) AS companies_total,
(SELECT count() FROM analytics_1c.company_registry) AS registry_rows_total,
(SELECT count() FROM analytics_1c.company_forecasts) AS forecasts_total,
(SELECT count() FROM analytics_1c.company_health_signals) AS health_signals_total
FROM analytics_1c.documents
"""
)
)[0]
return {"status": "ok", "generated_at": datetime.now(UTC).isoformat(), **summary}
@app.get("/api/health")
def api_health() -> dict[str, Any]:
return health()
@app.get("/api/1/analytics-1c/companies/overview")
def companies_overview(
infobase: str | None = None,
min_signal_score: int = Query(default=0, ge=0, le=100),
limit: int = Query(default=50, ge=1, le=500),
) -> dict[str, Any]:
client = ch_client()
where = [f"signal_score >= {int(min_signal_score)}"]
if infobase:
where.append(f"infobase = {q(infobase)}")
sql = f"""
SELECT
infobase,
company_entity_key,
organization,
counterparty,
source_counterparty,
company_name,
normalized_counterparty,
registry_match_mode,
registry_company_key,
registry_binding_source,
registry_binding_note,
registry_assignee_name,
registry_status,
registry_share_text,
registry_key_contour,
registry_inn,
registry_kpp,
owner_user,
base_path,
current_status,
db_size_bytes,
reglog_size_bytes,
active_locks,
current_activity_score,
last_seen_at,
days_since_last_activity,
docs_7d,
amount_7d,
docs_30d,
amount_30d,
amount_forecast_30d,
docs_forecast_30d,
signal_severity,
signal_score,
top_signal
FROM analytics_1c.v_company_portfolio_overview
WHERE {' AND '.join(where)}
ORDER BY signal_score DESC, amount_30d DESC, counterparty
LIMIT {int(limit)}
"""
rows = rows_to_dict(client.query(sql))
return {"items": rows, "count": len(rows)}
@app.get("/api/1/analytics-1c/companies/{counterparty}/summary")
def company_summary(counterparty: str, infobase: str | None = None) -> dict[str, Any]:
client = ch_client()
card = resolve_company_portfolio_card(counterparty, infobase)
entity_key = str(card.get("company_entity_key") or "")
forecast_sql = f"""
SELECT metric, horizon_days, baseline_daily, trend_slope, predicted_daily, predicted_total, confidence, note
FROM analytics_1c.v_company_forecasts_current
WHERE counterparty = {q(entity_key)}
{"AND infobase = " + q(str(card.get('infobase') or infobase)) if (card.get('infobase') or infobase) else ""}
ORDER BY metric, horizon_days
"""
signals_sql = f"""
SELECT generated_at, severity, score, signal_type, summary
FROM analytics_1c.v_company_health_current
WHERE counterparty = {q(entity_key)}
{"AND infobase = " + q(str(card.get('infobase') or infobase)) if (card.get('infobase') or infobase) else ""}
ORDER BY score DESC, generated_at DESC
"""
timeline_sql = f"""
SELECT last_company_snapshot_at AS ts, infobase, company_name, owner_user, current_status, db_size_bytes, reglog_size_bytes, active_locks, current_activity_score
FROM analytics_1c.v_company_portfolio_overview
WHERE company_entity_key = {q(entity_key)}
{"AND infobase = " + q(str(card.get('infobase') or infobase)) if (card.get('infobase') or infobase) else ""}
ORDER BY ts DESC
LIMIT 1
"""
forecasts = rows_to_dict(client.query(forecast_sql))
signals = rows_to_dict(client.query(signals_sql))
company_state = rows_to_dict(client.query(timeline_sql))
timeline_sql = f"""
SELECT ts, infobase, doc_type, operation_type, amount, status, author
FROM analytics_1c.documents
WHERE infobase = {q(str(card.get('infobase') or infobase or ''))}
AND counterparty != ''
ORDER BY ts DESC
LIMIT 20
"""
timeline = rows_to_dict(client.query(timeline_sql))
essence = (
f"Компания {card['counterparty']}: за 30 дней событий {card['docs_30d']}, суммарная активность {card['amount_30d']}, "
f"прогноз активности на 30 дней {card['amount_forecast_30d']}, риск {card['signal_severity']}."
)
payload = {
"essence": essence,
"card": card,
"company_state": company_state[0] if company_state else None,
"forecasts": forecasts,
"signals": signals,
"recent_documents": timeline,
"management_actions": company_management_actions(counterparty, infobase, limit=10),
}
payload["priority_context"] = build_company_priority_context(payload, infobase)
payload["recovery_context"] = build_company_recovery_context(payload, infobase)
return payload
@app.get("/api/1/analytics-1c/companies/{counterparty}/forecast")
def company_forecast(
counterparty: str,
infobase: str | None = None,
horizon_days: int | None = Query(default=None, ge=1, le=365),
) -> dict[str, Any]:
client = ch_client()
card = resolve_company_portfolio_card(counterparty, infobase)
filters = [f"counterparty = {q(str(card.get('company_entity_key') or counterparty))}"]
if card.get("infobase") or infobase:
filters.append(f"infobase = {q(str(card.get('infobase') or infobase))}")
if horizon_days is not None:
filters.append(f"horizon_days = {int(horizon_days)}")
sql = f"""
SELECT generated_at, infobase, counterparty, metric, horizon_days, baseline_daily, trend_slope, predicted_daily, predicted_total, confidence, note
FROM analytics_1c.v_company_forecasts_current
WHERE {' AND '.join(filters)}
ORDER BY metric, horizon_days
"""
rows = rows_to_dict(client.query(sql))
return {"items": rows, "count": len(rows)}
@app.get("/api/1/analytics-1c/companies/{counterparty}/timeline")
def company_timeline(
counterparty: str,
infobase: str | None = None,
limit: int = Query(default=100, ge=1, le=500),
) -> dict[str, Any]:
client = ch_client()
card = resolve_company_portfolio_card(counterparty, infobase)
filters = [f"infobase = {q(str(card.get('infobase') or infobase or ''))}", "counterparty != ''"]
sql = f"""
SELECT ts, infobase, organization, doc_type, doc_number, author, operation_type, amount, status, posted
FROM analytics_1c.documents
WHERE {' AND '.join(filters)}
ORDER BY ts DESC
LIMIT {int(limit)}
"""
rows = rows_to_dict(client.query(sql))
return {"items": rows, "count": len(rows)}
@app.get("/api/1/analytics-1c/companies/{counterparty}/actions")
def company_actions(counterparty: str, infobase: str | None = None, limit: int = Query(default=20, ge=1, le=100)) -> dict[str, Any]:
items = company_management_actions(counterparty, infobase, limit=limit)
return {"items": items, "count": len(items)}
@app.get("/api/1/analytics-1c/manager/brief/latest")
def manager_brief_latest() -> dict[str, Any]:
return load_latest_manager_brief()
@app.get("/api/1/analytics-1c/manager/brief/latest.md", response_class=PlainTextResponse)
def manager_brief_latest_markdown() -> str:
latest_md = manager_brief_state_dir() / "latest.md"
if not latest_md.exists():
raise HTTPException(status_code=404, detail="manager brief markdown not generated yet")
return latest_md.read_text(encoding="utf-8")
@app.get("/api/1/analytics-1c/manager/brief/history")
def manager_brief_history(limit: int = Query(default=20, ge=1, le=200)) -> dict[str, Any]:
items = load_brief_history_records(limit)
return {"items": items, "count": len(items)}
@app.get("/api/1/analytics-1c/manager/brief/history/{name}")
def manager_brief_history_record(name: str) -> dict[str, Any]:
return load_brief_history_record(name)
@app.get("/api/1/analytics-1c/manager/brief/delta/latest")
def manager_brief_delta_latest() -> dict[str, Any]:
payload = load_latest_manager_brief()
delta = extract_delta(payload)
return {
"generated_at": payload.get("generated_at"),
"headline": payload.get("brief", {}).get("headline"),
"delta": delta,
}
@app.get("/api/1/analytics-1c/manager/trends/weekly")
def manager_weekly_trends(days: int = Query(default=7, ge=2, le=30)) -> dict[str, Any]:
return build_weekly_trend_report(load_brief_history_payloads(limit=400), days=days)
@app.get("/api/1/analytics-1c/manager/digest/weekly/latest")
def manager_weekly_digest_latest() -> dict[str, Any]:
return load_latest_weekly_digest()
@app.get("/api/1/analytics-1c/manager/digest/weekly/latest.md", response_class=PlainTextResponse)
def manager_weekly_digest_latest_markdown() -> str:
latest_md = weekly_digest_state_dir() / "latest.md"
if not latest_md.exists():
raise HTTPException(status_code=404, detail="weekly digest markdown not generated yet")
return latest_md.read_text(encoding="utf-8")
@app.get("/api/1/analytics-1c/manager/recovery/latest")
def manager_recovery_latest() -> dict[str, Any]:
return load_latest_recovery_brief()
@app.get("/api/1/analytics-1c/manager/recovery/latest.md", response_class=PlainTextResponse)
def manager_recovery_latest_markdown() -> str:
latest_md = recovery_brief_state_dir() / "latest.md"
if not latest_md.exists():
raise HTTPException(status_code=404, detail="recovery brief markdown not generated yet")
return latest_md.read_text(encoding="utf-8")
@app.get("/api/1/analytics-1c/manager/actions")
def manager_actions_api(
priority_tier: str | None = Query(default=None),
owner: str | None = Query(default=None),
limit: int = Query(default=100, ge=1, le=500),
) -> dict[str, Any]:
items = management_actions(priority_tier=priority_tier, owner=owner, limit=limit)
return {
"scope": "action_items",
"priority_model": "enterprise_risk",
"owner_mode": "secondary_operational_metadata",
"items": items,
"count": len(items),
"priority_tier": priority_tier,
"owner": owner,
}
@app.get("/api/1/analytics-1c/manager/actions/companies")
def manager_company_actions_api(
priority_tier: str | None = Query(default=None),
owner: str | None = Query(default=None),
limit: int = Query(default=100, ge=1, le=500),
) -> dict[str, Any]:
items = management_company_actions(priority_tier=priority_tier, owner=owner, limit=limit)
return {
"scope": "companies",
"priority_model": "enterprise_risk",
"owner_mode": "secondary_operational_metadata",
"items": items,
"count": len(items),
"priority_tier": priority_tier,
"owner": owner,
}
@app.get("/api/1/analytics-1c/companies/problematic")
def problematic_companies_api(
days: int = Query(default=7, ge=1, le=30),
limit: int = Query(default=50, ge=1, le=500),
) -> dict[str, Any]:
items = problematic_companies(days=days, limit=limit)
return {"items": items, "count": len(items), "days": days}
@app.get("/manager/brief", response_class=HTMLResponse)
def manager_brief_view() -> str:
return render_manager_brief_html(load_latest_manager_brief())
@app.get("/manager/changes", response_class=HTMLResponse)
def manager_brief_delta_view() -> str:
return render_brief_delta_html(load_latest_manager_brief())
@app.get("/manager/trends/weekly", response_class=HTMLResponse)
def manager_weekly_trends_view(days: int = Query(default=7, ge=2, le=30)) -> str:
return render_weekly_trend_html(build_weekly_trend_report(load_brief_history_payloads(limit=400), days=days))
@app.get("/manager/digest/weekly", response_class=HTMLResponse)
def manager_weekly_digest_view() -> str:
return render_weekly_digest_html(load_latest_weekly_digest())
@app.get("/manager/recovery", response_class=HTMLResponse)
def manager_recovery_view() -> str:
return render_recovery_brief_html(load_latest_recovery_brief())
@app.get("/manager/actions", response_class=HTMLResponse)
def manager_actions_view(
priority_tier: str | None = Query(default=None),
owner: str | None = Query(default=None),
limit: int = Query(default=100, ge=1, le=500),
) -> str:
return render_management_actions_html(
management_actions(priority_tier=priority_tier, owner=owner, limit=limit),
management_company_actions(priority_tier=priority_tier, owner=owner, limit=limit),
priority_tier=priority_tier,
owner=owner,
)
@app.get("/manager/briefs", response_class=HTMLResponse)
def manager_brief_history_view(limit: int = Query(default=40, ge=1, le=200)) -> str:
return render_brief_history_html(load_brief_history_records(limit))
@app.get("/manager/briefs/{name}", response_class=HTMLResponse)
def manager_brief_history_detail_view(name: str) -> str:
return render_manager_brief_html(load_brief_history_record(name))
@app.get("/manager/briefs/{name}/changes", response_class=HTMLResponse)
def manager_brief_history_delta_view(name: str) -> str:
return render_brief_delta_html(load_brief_history_record(name))
@app.get("/manager/problematic", response_class=HTMLResponse)
def manager_problematic_companies_view(
days: int = Query(default=7, ge=1, le=30),
limit: int = Query(default=50, ge=1, le=500),
) -> str:
return render_problematic_companies_html(problematic_companies(days=days, limit=limit), days)
def render_company_detail_html(summary_payload: dict[str, Any], infobase: str | None = None) -> str:
card = summary_payload["card"]
company_state = summary_payload.get("company_state") or {}
forecasts = summary_payload.get("forecasts") or []
signals = summary_payload.get("signals") or []
recent_documents = summary_payload.get("recent_documents") or []
management_actions_payload = summary_payload.get("management_actions") or []
priority_context = summary_payload.get("priority_context") or build_company_priority_context(summary_payload, infobase)
recovery_context = summary_payload.get("recovery_context") or build_company_recovery_context(summary_payload, infobase)
title = card.get("counterparty", "Карточка компании")
subtitle = summary_payload.get("essence", "")
grafana_url = grafana_company_dashboard_url()
company_ref = str(card.get("company_entity_key") or card.get("counterparty") or "")
summary_url = f"/api/1/analytics-1c/companies/{quote(company_ref)}/summary"
if infobase:
summary_url += f"?infobase={quote(infobase)}"
timeline_url = f"/api/1/analytics-1c/companies/{quote(company_ref)}/timeline"
if infobase:
timeline_url += f"?infobase={quote(infobase)}"
forecast_url = f"/api/1/analytics-1c/companies/{quote(company_ref)}/forecast"
if infobase:
forecast_url += f"?infobase={quote(infobase)}"
actions_url = f"/api/1/analytics-1c/companies/{quote(company_ref)}/actions"
if infobase:
actions_url += f"?infobase={quote(infobase)}"
if card.get("signal_severity") == "critical":
manager_comment = "Компания требует немедленного внимания: контур считает её operational-critical."
elif card.get("signal_severity") == "high":
manager_comment = "Компания в зоне повышенного внимания: нужен короткий управленческий разбор причин сигнала."
elif card.get("signal_severity") == "medium":
manager_comment = "Компания не аварийная, но требует точечной проверки причин отклонения."
else:
manager_comment = "По компании нет выраженного аварийного сигнала; смотреть контекст и тренд активности."
metrics = [
("Активность 7д", fmt_number(card.get("amount_7d"))),
("Активность 30д", fmt_number(card.get("amount_30d"))),
("Прогноз 30д", fmt_number(card.get("amount_forecast_30d"))),
("Документы 30д", fmt_number(card.get("docs_30d"))),
("Кейсы", fmt_number(card.get("open_cases_total"))),
("Detections", fmt_number(card.get("detections_total"))),
]
metric_cards = "".join(
f"{html.escape(label)}
{html.escape(value)}
"
for label, value in metrics
)
evidence_items = "".join(
f"{html.escape(str(item))}"
for item in priority_context.get("evidence", [])
)
action_items = "".join(
f"{html.escape(str(item))}"
for item in priority_context.get("actions", [])
)
recovery_action_items = "".join(
f"{html.escape(str(item))}"
for item in recovery_context.get("actions", [])
)
management_action_items = []
for item in management_actions_payload[:6]:
management_action_items.append(
""
f"{severity_badge(str(item.get('priority_tier') or 'low'))} "
f"{html.escape(str(item.get('recommended_action') or '-'))} "
f"({html.escape(str(item.get('deadline_hint') or '-'))})"
f"
{html.escape(str(item.get('reason') or '-'))}"
""
)
forecast_rows = []
for item in forecasts:
forecast_rows.append(
""
f"| {html.escape(str(item.get('metric', '-')))} | "
f"{fmt_number(item.get('horizon_days'))} | "
f"{fmt_number(item.get('baseline_daily'))} | "
f"{fmt_number(item.get('predicted_total'))} | "
f"{fmt_number(item.get('confidence'))} | "
f"{html.escape(str(item.get('note', '-')))} | "
"
"
)
signal_rows = []
for item in signals[:12]:
signal_rows.append(
""
f"| {html.escape(str(item.get('generated_at', '-')))} | "
f"{severity_badge(str(item.get('severity', 'none')))} | "
f"{fmt_number(item.get('score'))} | "
f"{html.escape(str(item.get('signal_type', '-')))} | "
f"{html.escape(str(item.get('summary', '-')))} | "
"
"
)
document_rows = []
for item in recent_documents[:20]:
document_rows.append(
""
f"| {html.escape(str(item.get('ts', '-')))} | "
f"{html.escape(str(item.get('doc_type', '-')))} | "
f"{html.escape(str(item.get('operation_type', '-')))} | "
f"{fmt_number(item.get('amount'))} | "
f"{html.escape(str(item.get('status', '-')))} | "
f"{html.escape(str(item.get('author', '-')))} | "
"
"
)
registry_comment = (
f"Сопоставление с реестром: {card.get('registry_match_mode', 'none')}. "
f"Ответственный: {card.get('registry_assignee_name') or 'не указан'}."
)
if card.get("registry_match_mode") == "manual":
registry_comment += " Требуется осторожность: запись заведена через manual override."
return f"""
{html.escape(title)} · 1C Company Brief
Управленческий комментарий
{html.escape(manager_comment)}
{html.escape(registry_comment)}
Сейчас база в состоянии {html.escape(str(card.get("current_status", "-")))}, активных блокировок: {fmt_number(card.get("active_locks"))}, дней с последней активности: {fmt_number(card.get("days_since_last_activity"))}.
Ключевые метрики
{metric_cards}
Почему приоритет высокий именно у этой компании
{html.escape(str(priority_context.get("verdict") or "-"))}
Текущий приоритет: {severity_badge(str(priority_context.get("current_priority_tier") or "low"))}
· score {html.escape(fmt_number(priority_context.get("current_priority_score")))}
· причина: {html.escape(str(priority_context.get("current_priority_reason") or "-"))}
Что проверить первым действием
Текущие управленческие действия по компании
AI-план снятия проблемы
Диагноз: {html.escape(str(recovery_context.get("diagnosis") or "-"))}
Что не делать: {html.escape(str(recovery_context.get("stop_doing") or "-"))}
Цель 24ч: {html.escape(str(recovery_context.get("target_state_24h") or "-"))}
Источник: {html.escape(str(recovery_context.get("confidence") or "-"))}
{f" · сформировано {html.escape(str(recovery_context.get('generated_at')))}" if recovery_context.get("generated_at") else ""}
Карточка компании
Состояние файловой базы
Прогнозы
| Метрика |
Горизонт, д |
Baseline |
Прогноз total |
Confidence |
Примечание |
{''.join(forecast_rows) or '| Нет данных. |
'}
Сигналы
| Время |
Severity |
Score |
Тип |
Комментарий |
{''.join(signal_rows) or '| Нет данных. |
'}
Последние события
| Время |
Тип |
Операция |
Активность |
Статус |
Автор |
{''.join(document_rows) or '| Нет данных. |
'}
"""
@app.get("/manager/company/{counterparty}", response_class=HTMLResponse)
def manager_company_view(counterparty: str, infobase: str | None = None) -> str:
return render_company_detail_html(company_summary(counterparty, infobase), infobase)
if __name__ == "__main__":
args = parse_args()
uvicorn.run(app, host=args.host, port=args.port)