Files
sfera/PROJECT_OVERVIEW.md
T
2026-05-16 19:03:49 +03:00

96 lines
6.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.