Initial SFERA platform baseline

2026-05-16 19:03:49 +03:00
commit 3b845c8fce
282 changed files with 55045 additions and 0 deletions
@@ -0,0 +1,95 @@
+# 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.