# SFERA — полный анализ проекта для Codex

## Что строим

SFERA — серверная semantic SDLC платформа для 1С:

- semantic graph 1С-конфигурации;
- полноценная IDE-среда для ручной и AI-assisted разработки 1С;
- object-level versioning вместо обязательного Git;
- task-linked изменения;
- review/impact/runtime intelligence;
- knowledge-aware AI, который умеет анализировать, писать и изменять 1С-код и metadata;
- агенты EPF/CFE;
- marketplace/download center;
- многопользовательская серверная консоль.

## Продуктовая формула

```text
SIR + Lineage + Object Versioning + Runtime Overlay + Knowledge Base + Collaboration
```

Расширенная формула продукта:

```text
Semantic Core + 1C IDE + AI Pair Programmer + Object/Form Designer + Guarded Apply
```

## Что не делаем в начале

- автоприменение изменений в production;
- автономное применение AI-изменений без preview/diff/approval;
- полный live debugger;
- сложную marketplace-экосистему;
- heavy frontend до ядра.

## IDE и authoring стратегия

SFERA должна уметь всё, что ожидается от современной IDE для 1С, но опираясь на semantic graph и структуру конфигурации:

- ручное редактирование BSL-кода с подсветкой, диагностикой, навигацией, поиском ссылок и refactoring;
- AI autocomplete и продолжение кода с учётом текущей процедуры, локальных переменных, параметров, доступных реквизитов, табличных частей, форм, команд, ролей и связей объекта;
- AI generation для процедур, функций, обработчиков команд, запросов, движений регистров и безопасных шаблонов 1С;
- создание и изменение объектов 1С: документы, справочники, регистры, общие модули, реквизиты, табличные части, команды, формы и отчёты;
- visual/object designer для metadata, форм, команд, реквизитов, табличных частей и отчётов;
- preview/diff всех изменений перед применением;
- guarded apply: проверка impact, прав, privacy, review findings, style rules и AI policy до записи изменений;
- AI объясняет, почему предлагает именно такой код, какие объекты будут затронуты и какие риски есть.

## Что берём из 1С Конфигуратора

SFERA не копирует старый интерфейс Конфигуратора, но сохраняет его сильную рабочую модель, знакомую 1С-разработчикам:

- дерево конфигурации как основной навигатор по метаданным, модулям, формам, реквизитам, командам, ролям и регистрам;
- отдельные рабочие режимы для модуля, формы, реквизитов/табличных частей, команд, свойств, событий и обработчиков;
- вкладки открытых объектов и быстрый переход между модулем объекта, модулем формы, дизайнером формы, свойствами и событиями;
- правый инспектор свойств/событий, который меняет содержимое по выбранному объекту или элементу формы;
- нижние панели проблем, ссылок, output, preview, diff и статуса выполнения;
- поиск по дереву, объектам, процедурам, событиям, формам и документации.

Поверх этой модели SFERA добавляет то, чего нет в классическом Конфигураторе как единой среды:

- object-level версии и rollback для каждого изменения;
- semantic diff, impact analysis и guarded apply перед записью;
- документацию проекта, vendor/BSP docs, базу знаний, паттерны команды и историю решений прямо в IDE;
- обучение и подсказки для разработчиков по текущему объекту, коду и стандартам команды;
- AI pair programmer, который умеет читать контекст 1С, писать код, создавать объекты/формы/отчёты и объяснять риски;
- task/session binding, audit trail, права доступа, privacy policy и учёт AI token/cost impact.

## Первый технический proof

```text
BSL file
↓
Rust parser
↓
SIR Snapshot
↓
Neo4j graph
↓
find_callers / find_callees
```

## Языковая стратегия

- UI по умолчанию русский.
- В интерфейсе и командах русский язык используется по умолчанию.
- Пользователь должен иметь возможность выбрать английский язык интерфейса и английский вариант написания команд.
- Внутренний код/модели — английский.
- BSL parser обязан понимать русские и английские ключевые слова: `Процедура/Procedure`, `Функция/Function`, `КонецПроцедуры/EndProcedure` и т.д.
- В одном BSL-тексте 1С допустима смесь русских и английских ключевых слов/команд; SFERA обязана это поддерживать.

## Git strategy

Git не является обязательным source of truth. История SFERA хранится в Semantic Object Version Store. Git — только optional import/export adapter.