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,35 @@
+# SFERA Frontend Product Contract
+
+SFERA - это серверная semantic IDE-платформа для 1С, а не dashboard, CRM или файловый редактор.
+
+## Главная модель
+
+- Проект выбирается в верхней панели.
+- Пользователь долго работает внутри одного проекта.
+- Основной экран - IDE workspace последнего проекта.
+- Если проекта нет - пустой workspace с выбором или созданием проекта.
+- Левая панель - навигация по текущему проекту.
+- Центр - рабочая область.
+- Правая панель - контекстные свойства.
+- Нижняя зона - открытые объекты, служебные панели и status bar.
+
+## Product Principles
+
+SFERA должна быть metadata-first: в 1С дерево объектов конфигурации представляет прикладное решение как древовидную структуру логически связанных объектов.
+
+Расширения являются configuration-like структурами: расширение похоже на обычную конфигурацию и тоже представляется деревом объектов.
+
+Формы - visual-first: формы 1С предназначены для просмотра и редактирования данных и могут принадлежать объектам конфигурации или быть общими.
+
+Окно объекта конфигурации в 1С предназначено для редактирования свойств, управления подчиненными объектами и настройки взаимодействия объектов. SFERA должна расширять эту модель, а не заменять ее dashboard-карточками.
+
+## Official 1C Documentation
+
+При проектировании 1C-specific поведения использовать официальные источники:
+
+- ITS;
+- v8.1c.ru;
+- 1C DN;
+- локальные knowledge packs.
+
+ITS credentials нельзя хранить в документации или репозитории. Доступ передается только через `.env.local`.