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,46 @@
+# Codex Instructions for SFERA Docs
+
+## Frontend Contract Rules
+
+Перед любым изменением frontend:
+
+1. Прочитать `docs/frontend/SFERA_FRONTEND_PRODUCT_CONTRACT.md`.
+2. Прочитать `docs/frontend/SFERA_IDE_UI_CONTRACT.md`.
+3. Если меняется дерево 1С - прочитать `docs/frontend/SFERA_METADATA_TREE_CONTRACT.md`.
+4. Если меняются настройки проекта - прочитать `docs/frontend/SFERA_PROJECT_SETTINGS_CONTRACT.md`.
+5. Если контракт устарел - сначала обновить контракт, затем код.
+6. Все UI-изменения фиксировать в `docs/frontend/SFERA_FRONTEND_CHANGELOG.md`.
+
+Frontend SFERA нельзя переводить в dashboard, CRM или файловый редактор. Принятая модель сохраняется:
+
+- SFERA = metadata-first semantic configurator for 1C;
+- основной экран = IDE последнего проекта;
+- проект выбирается сверху;
+- левая панель = дерево текущего проекта;
+- основная конфигурация и расширения = configuration-like roots одного уровня;
+- центр = рабочая область;
+- правая панель = контекстные свойства;
+- низ = открытые объекты, tools и status.
+
+Для 1C-specific поведения использовать официальную документацию:
+
+- ITS;
+- v8.1c.ru;
+- 1C DN;
+- локальные knowledge packs.
+
+ITS credentials передаются только через `.env.local`:
+
+```dotenv
+SFERA_ITS_URL=<ITS_URL>
+SFERA_ITS_USERNAME=<ITS_USERNAME>
+SFERA_ITS_PASSWORD=<ITS_PASSWORD>
+```
+
+Запрещено:
+
+- хранить реальные ITS credentials в репозитории;
+- писать реальные логины или пароли в markdown;
+- писать реальные логины или пароли в Dockerfile;
+- выводить реальные логины или пароли в logs;
+- коммитить `.env.local` и `.env.*.local`.