docs(1c): publish ai investigator runtime summary

2026-05-22 21:36:55 +03:00
parent 6cb1e0a95b
commit 6b246aaa14
3 changed files with 273 additions and 0 deletions
@@ -14,6 +14,7 @@
 - `docs/PRESENTATION_RU.md` — презентационные экраны Grafana и AW-rus со скриншотами.
 - `docs/1C_FILE_ANALYTICS_STACK_RU.md` — production guide по файловой 1С Detmir: topology, rollout, verification, recovery, task principal и hardening.
 - `docs/1C_COMPANY_INTELLIGENCE_RU.md` — слой анализа и прогноза по компаниям поверх `clickhouse-1c`: marts, forecasting, API и Grafana; в file-based Detmir контуре это прогноз активности компаний/баз по read-only telemetry.
+- `docs/1C_AI_INVESTIGATOR_RUNTIME_RU.md` — сводка текущего production runtime: manager pages, recovery briefs, weekly digest, company entity keys и live topology.
 - `docs/windows/ensemble.md` — orchestration-пакет для Windows-деплоя и проверки.
 - `docs/linux-client.md` — user-space rollout Linux-клиента ActivityWatch на удалённый `AW server`.
 - `docs/linux-remote-worker.md` — полный Linux remote-worker stack: GUI, SSH/console и browser admin UI вроде Proxmox `:8006`.
@@ -0,0 +1,271 @@
+# 1C AI Investigator Runtime для AW-rus
+
+Этот документ фиксирует **что уже реально сделано** в production-контуре
+файловой 1С на базе `AW-rus`.
+
+Речь не о целевой идее и не о roadmap, а о текущем рабочем состоянии.
+
+## Что уже есть
+
+Сейчас в `AW-rus` уже существует замкнутый контур:
+
+```text
+File 1C / Windows RDP host
+  -> read-only export / telemetry
+  -> ClickHouse on 10.10.10.2
+  -> detections / cases / timeline / company intelligence
+  -> manager briefs / recovery briefs / weekly digest
+  -> Grafana on 10.10.10.11
+  -> browser pages and read-only API
+```
+
+Это уже не просто сбор метрик.
+
+Это production-слой:
+
+- расследований;
+- executive summaries;
+- company intelligence;
+- explainable forecasting;
+- AI-assisted manager output.
+
+## Production topology
+
+### Источник
+
+- `192.168.100.18`
+  - файловая 1С;
+  - scheduled task `\ActivityWatch File1C Upload`;
+  - read-only export без записи в `1Cv8.1CD`.
+
+### Analytics node
+
+- `10.10.10.2`
+  - `ClickHouse`;
+  - ETL/ingest;
+  - company intelligence refresh;
+  - manager brief generation;
+  - weekly digest generation;
+  - recovery brief generation;
+  - read-only API.
+
+### Visualization
+
+- `10.10.10.11`
+  - `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 для руководителя
+
+На `10.10.10.2:8710` уже работают human-facing страницы:
+
+- `/manager/brief`
+- `/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` на `10.10.10.2` превращает это в:
+   - 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 остались, но перестали быть единственной опорой.
+
+## Что именно уже автоматизировано
+
+На `10.10.10.2` автоматизированы:
+
+- 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://10.10.10.11:3000/dashboards/f/file-1c/?orgId=1`
+- company intelligence:
+  - `http://10.10.10.11:3000/d/1c-file-companies/1c-file-company-intelligence`
+
+### Manager UI
+
+- `http://10.10.10.2:8710/manager/brief`
+- `http://10.10.10.2:8710/manager/changes`
+- `http://10.10.10.2:8710/manager/trends/weekly`
+- `http://10.10.10.2:8710/manager/digest/weekly`
+- `http://10.10.10.2: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/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`
+
+## Главная граница
+
+Контур 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.
@@ -17,6 +17,7 @@
 - [Security analytics stack v1](../security-analytics-stack-v1.md) - целевая v1-модель без претензии на Splunk-class SIEM
 - [File 1C analytics](File-1C-Analytics) - ClickHouse/Grafana/AI Investigator контур для файловой 1С
 - [1C Company Intelligence](1C-Company-Intelligence) - AI-ready слой анализа и прогноза по компаниям поверх файловой 1С
+- [1C AI Investigator Runtime](../1C_AI_INVESTIGATOR_RUNTIME_RU.md) - что уже реально сделано в production: topology, manager UI, briefs, recovery и границы контура

 ### Компоненты
 - [DLP Endpoint Monitoring](DLP-Endpoint-Monitoring) - мониторинг clipboard, печати, USB