Files
AWatch-rus/docs/1C_AI_INVESTIGATOR_RUNTIME_RU.md
T

8.4 KiB
Raw Blame History

1C AI Investigator Runtime для AW-rus

Этот документ фиксирует что уже реально сделано в production-контуре файловой 1С на базе AW-rus.

Речь не о целевой идее и не о roadmap, а о текущем рабочем состоянии.

Что уже есть

Сейчас в AW-rus уже существует замкнутый контур:

File 1C / Windows RDP host
  -> read-only export / telemetry
  -> ClickHouse on <GATEWAY_HOST>
  -> detections / cases / timeline / company intelligence
  -> manager briefs / recovery briefs / weekly digest
  -> Grafana on <GRAFANA_HOST>
  -> browser pages and read-only API

Это уже не просто сбор метрик.

Это production-слой:

  • расследований;
  • executive summaries;
  • company intelligence;
  • explainable forecasting;
  • AI-assisted manager output.

Production topology

Источник

  • <WINDOWS_HOST>
    • файловая 1С;
    • scheduled task \ActivityWatch File1C Upload;
    • read-only export без записи в 1Cv8.1CD.

Analytics node

  • <GATEWAY_HOST>
    • ClickHouse;
    • ETL/ingest;
    • company intelligence refresh;
    • manager brief generation;
    • weekly digest generation;
    • recovery brief generation;
    • read-only API.

Visualization

  • <GRAFANA_HOST>
    • Grafana;
    • folder file-1c;
    • dashboards для audit, detections, timeline, company intelligence.

Что подтверждено в live

Ingest и telemetry

Подтверждены рабочие слои:

  • documents
  • reglog_events
  • audit_events
  • host_events
  • entity_timeline
  • detections
  • cases
  • companies
  • company_registry
  • company_forecasts
  • company_health_signals

Контур уже умеет:

  • грузить read-only snapshots;
  • собирать timeline;
  • открывать detections/cases;
  • считать сигналы и прогнозы;
  • формировать human-facing manager output.

Company intelligence

Подтверждён production-layer по компаниям:

  • overview
  • summary
  • forecast
  • timeline
  • priority / delta / weekly trend
  • recovery brief

Browser pages для руководителя

На <GATEWAY_HOST>:8710 уже работают human-facing страницы:

  • /manager/brief
  • /manager/actions
  • /manager/changes
  • /manager/trends/weekly
  • /manager/digest/weekly
  • /manager/problematic?days=1
  • /manager/problematic?days=7
  • /manager/recovery
  • /manager/briefs
  • /manager/company/{company}

Это не raw JSON.

Это страницы для руководителя с:

  • headline;
  • очередью конкретных действий по компаниям;
  • summary;
  • top risks;
  • top changes;
  • weekly digest;
  • recovery actions;
  • приоритетами;
  • пояснением, почему компания красная.

Grafana

Подтверждены рабочие dashboards:

  • 1C File - Audit Overview
  • 1C File - Company Intelligence
  • 1C File - Data Quality
  • 1C File - Detections
  • 1C File - Executive Summary
  • 1C File - Investigation Timeline
  • 1C File - Operations Health

Что делает AI-слой

Сейчас AI в этом контуре не заменяет расчёты и не лезет напрямую в 1С.

Он работает поверх уже собранной аналитики:

  1. ingest грузит read-only данные;
  2. ClickHouse строит canonical marts и signals;
  3. forecasting layer считает 7/30 day expectations;
  4. local codex на <GATEWAY_HOST> превращает это в:
    • manager brief;
    • recovery brief;
    • weekly digest;
    • human-facing company pages.

То есть текущий AI-слой — это:

  • explanation;
  • prioritization;
  • recovery guidance;
  • executive narrative.

Ключевое инженерное решение

Контур больше не опирается на “название компании в 1С” как на единственный ключ.

Введён company_entity_key:

  • сначала baseid:<base_id>;
  • потом basepath:<normalized path>;
  • потом только fallback infobase:<...>.

Это значит:

  • runtime не ломается от rename;
  • forecasts/signals/cases/timeline живут вокруг technical identity;
  • human labels остались, но перестали быть единственной опорой.

Что именно уже автоматизировано

На <GATEWAY_HOST> автоматизированы:

  • ingest cycle;
  • post-ingest refresh manager brief;
  • post-ingest refresh recovery brief;
  • periodic proofcheck;
  • weekly digest timer;
  • browser/API access to latest artifacts.

Контур уже умеет:

  • не пустеть при сбое LLM;
  • отдавать deterministic fallback;
  • хранить history;
  • строить delta между brief'ами;
  • считать weekly trend;
  • ранжировать top changes по приоритету.

Что это пока НЕ делает

Нужно говорить жёстко.

Это ещё не полноценная финансовая расследовательная платформа по проводкам.

Текущие ограничения:

  • file-based telemetry слой не равен бухгалтерскому ledger;
  • amount в company intelligence сейчас может быть activity score, а не деньги;
  • часть company-layer пока telemetry-derived;
  • без отдельного read-only business extract не будет честного проводочного расследования по дебету/кредиту.

То есть сейчас это уже:

  • AI Operational / Company Investigation Platform

но ещё не полностью:

  • AI Financial Investigation Platform по бухгалтерским проводкам.

Где смотреть

Grafana

  • http://<GRAFANA_HOST>:3000/dashboards/f/file-1c/?orgId=1
  • management board:
    • http://<GRAFANA_HOST>:3000/d/1c-file-mgmt/1c-file-management-board
  • financial reporting:
    • http://<GRAFANA_HOST>:3000/d/1c-file-finance/1c-file-financial-reporting
  • telemetry board:
    • http://<GRAFANA_HOST>:3000/d/1c-file-telemetry/1c-file-telemetry-board
  • company intelligence:
    • http://<GRAFANA_HOST>:3000/d/1c-file-companies/1c-file-company-intelligence

Manager UI

  • http://<GATEWAY_HOST>:8710/manager/brief
  • http://<GATEWAY_HOST>:8710/manager/changes
  • http://<GATEWAY_HOST>:8710/manager/trends/weekly
  • http://<GATEWAY_HOST>:8710/manager/digest/weekly
  • http://<GATEWAY_HOST>:8710/manager/recovery

API

  • GET /health
  • GET /api/1/analytics-1c/companies/overview
  • GET /api/1/analytics-1c/companies/{company}/summary
  • GET /api/1/analytics-1c/companies/{company}/forecast
  • GET /api/1/analytics-1c/companies/{company}/actions
  • GET /api/1/analytics-1c/manager/actions
  • GET /api/1/analytics-1c/manager/actions/companies
  • GET /api/1/analytics-1c/manager/brief/latest
  • GET /api/1/analytics-1c/manager/brief/delta/latest
  • GET /api/1/analytics-1c/manager/trends/weekly
  • GET /api/1/analytics-1c/manager/digest/weekly/latest
  • GET /api/1/analytics-1c/manager/recovery/latest

Manager action API работает в enterprise-first режиме:

  • priority_model=enterprise_risk
  • owner_mode=secondary_operational_metadata

Главная граница

Контур deliberately построен как read-only.

Он:

  • не пишет обратно в 1С;
  • не трогает 1Cv8.1CD;
  • не требует COM/Configurator/Designer;
  • не делает destructive actions внутри production 1С.

Следующий логичный шаг

Если нужен уже настоящий AI Financial Investigation Platform, а не только company/telemetry intelligence, следующий слой один:

  • read-only business event extraction:
    • документы;
    • движения;
    • проводки;
    • журнал регистрации;
    • изменения реквизитов.

Только после этого можно честно перейти к:

  • debit/credit investigations;
  • VAT anomaly narratives;
  • split-payment detection;
  • return/refund fraud patterns;
  • full financial AI investigations.