47 lines
2.1 KiB
Markdown
47 lines
2.1 KiB
Markdown
# 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`.
|