# 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`.