diff --git a/README.md b/README.md index b1441aa..601fdf9 100755 --- a/README.md +++ b/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`. diff --git a/clickhouse-1c/.env.example b/clickhouse-1c/.env.example index 597a133..c842680 100644 --- a/clickhouse-1c/.env.example +++ b/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 diff --git a/clickhouse-1c/README.md b/clickhouse-1c/README.md index 5c9b7db..5ad8744 100644 --- a/clickhouse-1c/README.md +++ b/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 слой останется корректно пустым. diff --git a/clickhouse-1c/ai/refresh_company_intelligence.py b/clickhouse-1c/ai/refresh_company_intelligence.py index 94bff90..cf9cc5b 100644 --- a/clickhouse-1c/ai/refresh_company_intelligence.py +++ b/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() diff --git a/docs/1C_COMPANY_INTELLIGENCE_RU.md b/docs/1C_COMPANY_INTELLIGENCE_RU.md index 5843cdf..1c0a44f 100644 --- a/docs/1C_COMPANY_INTELLIGENCE_RU.md +++ b/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С нет.