# 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 <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.
