docs(1c): clarify company activity forecasting semantics

README.md

@@ -13,7 +13,7 @@
 - `docs/GRAFANA_DASHBOARDS_RU.md` — импорт и сопровождение Grafana dashboard'ов через Ansible API playbook.
 - `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.
+- `docs/1C_COMPANY_INTELLIGENCE_RU.md` — слой анализа и прогноза по компаниям поверх `clickhouse-1c`: marts, forecasting, API и Grafana; в file-based Detmir контуре это прогноз активности компаний/баз по read-only telemetry.
 - `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`.

clickhouse-1c/.env.example

@@ -11,5 +11,5 @@ AW_1C_CLICKHOUSE_RUNTIME_HOST=127.0.0.1
 AW_1C_COMPANY_API_HOST=127.0.0.1
 AW_1C_COMPANY_API_PORT=8710
 AW_1C_COMPANY_LOOKBACK_DAYS=30
-AW_1C_COMPANY_MIN_DAYS=3
+AW_1C_COMPANY_MIN_DAYS=1
 AW_1C_COMPANY_HORIZONS=7,30

clickhouse-1c/README.md

@@ -134,7 +134,9 @@ python ai/company_intelligence_api.py --host 127.0.0.1 --port 8710
 - журнал регистрации 1С;
 - audit/export критичных изменений;
 - host telemetry с Windows/RDP host.
-- для company intelligence нужны документы с непустым `counterparty`.
+- для company intelligence в file-based Detmir контуре `counterparty`
+  наполняется read-only telemetry слоем как `counterparty = infobase`, а
+  `amount` используется как интегральный `activity score`.
 
 ## Границы
 
@@ -142,4 +144,5 @@ python ai/company_intelligence_api.py --host 127.0.0.1 --port 8710
 - LLM не ходит прямо в production 1С;
 - в ClickHouse кладутся нормализованные выгрузки и enrichment;
 - case/timeline слой считается вне 1С.
+- это прогноз активности компании/базы, а не финансовых проводок;
 - если `counterparty` в live-выгрузках пустой, company-forecast слой останется корректно пустым.

clickhouse-1c/ai/refresh_company_intelligence.py

@@ -21,7 +21,7 @@ def parse_args() -> argparse.Namespace:
     p.add_argument("--password", default=os.getenv("CLICKHOUSE_PASSWORD", ""))
     p.add_argument("--database", default=os.getenv("CLICKHOUSE_DB", "analytics_1c"))
     p.add_argument("--lookback-days", type=int, default=int(os.getenv("AW_1C_COMPANY_LOOKBACK_DAYS", "30")))
-    p.add_argument("--min-days", type=int, default=int(os.getenv("AW_1C_COMPANY_MIN_DAYS", "3")))
+    p.add_argument("--min-days", type=int, default=int(os.getenv("AW_1C_COMPANY_MIN_DAYS", "1")))
     p.add_argument("--horizons", default=os.getenv("AW_1C_COMPANY_HORIZONS", "7,30"))
     return p.parse_args()
 

docs/1C_COMPANY_INTELLIGENCE_RU.md

@@ -6,15 +6,21 @@
 
 - анализировать работу с компаниями (`counterparty`);
 - показывать, где компании выпали из активности;
-- считать простой, объяснимый прогноз по документам и объёму;
+- считать простой, объяснимый прогноз по событиям и activity score;
 - давать read-only API для AI Investigator и внешних аналитических сервисов.
 
 ## Что считается компанией
 
-В этом контуре компания = `documents.counterparty`.
+В file-based Detmir контуре компания = `documents.counterparty`, но это поле
+заполняется **не из бухгалтерских проводок**, а из read-only file-base telemetry:
 
-Если в live-выгрузках поле `counterparty` пустое, слой остаётся корректно пустым.
-Он не выдумывает данные и не пытается прогнозировать то, чего нет.
+- `counterparty = infobase`;
+- `doc_type = CompanyActivitySnapshot`;
+- `amount` = интегральный `activity score` по изменению базы, росту reglog,
+  lock/temp markers и scheduler activity.
+
+То есть это слой прогноза **операционной активности по компаниям/базам**, а не
+финансовый forecast по первичке.
 
 ## Что добавлено
 
@@ -149,7 +155,7 @@ clickhouse-client --queries-file clickhouse/init/04_company_intelligence.sql
 
 ## Ограничения
 
-- без `counterparty` в выгрузках слой пустой;
-- это прогноз тенденции, а не финансовое обещание;
+- в file-based telemetry `amount` означает `activity score`, а не деньги;
+- прогноз показывает тенденцию активности компании/базы, а не финансовое обещание;
 - API строго read-only;
 - никакой записи обратно в 1С нет.