sfera/docs/CODEX_INSTRUCTIONS.md

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:

SFERA_ITS_URL=<ITS_URL>
SFERA_ITS_USERNAME=<ITS_USERNAME>
SFERA_ITS_PASSWORD=<ITS_PASSWORD>

Запрещено:

• хранить реальные ITS credentials в репозитории;
• писать реальные логины или пароли в markdown;
• писать реальные логины или пароли в Dockerfile;
• выводить реальные логины или пароли в logs;
• коммитить .env.local и .env.*.local.