# 1C Plugin

Плагин для работы с 1С.

Основные направления:

- ответы по 1С и BSL;
- генерация и объяснение BSL-кода;
- помощь с запросами 1С;
- анализ метаданных;
- RAG по документации и внутренним правилам;
- накопление датасета для LoRA/adapter fine-tuning.

## Strategy

Сначала делаем RAG и инструменты работы с 1С. Дообучение добавляем после накопления качественных примеров.

## Layout

```text
plugins/1c/
  rag/
  metadata/
  tools/
  datasets/
  training/
  evals/
  adapters/
  agent/
```

## Healthcheck

```powershell
python scripts/check_1c_plugin.py --print
```

Короткий статус:

```powershell
python scripts/status_1c_plugin.py
```

Runbook: `docs/runbooks/1c-plugin-health.md`.

## Live 1C Interaction

Connector API and safety policies:

```text
docs/1c-extension-layer-plan.md
docs/1c-adapter-api-contract.md
plugins/1c/connector/contracts/openapi.yaml
plugins/1c/connector/policies/read-only-query.yaml
plugins/1c/connector/policies/change-workflow.yaml
```

Runbook: `docs/runbooks/1c-live-interaction.md`.

Отдельный подпроект-агент:

```text
plugins/1c/agent/
```

Документация и запуск: `docs/runbooks/1c-agent.md`.

## Standalone-Ready Connector

REST adapter is kept inside this monorepo, but its service boundary is
`plugins/1c/connector/`. It owns its OpenAPI contract, safety policies,
Dockerfile, compose file, service manifest, and environment template. The
runtime parser dependency is `plugins/1c/parser/`.

Start here before extracting it to a separate repository:

```text
plugins/1c/connector/README.md
plugins/1c/connector/service.yaml
plugins/1c/connector/pyproject.toml
```