# Codex UI Guidelines для SFERA

## Роль Codex

Codex должен работать как senior frontend engineer + product designer.

Он обязан:
- соблюдать design system
- использовать русский язык интерфейса и команд по умолчанию
- предусматривать выбор английского языка интерфейса
- не генерировать случайные стили
- переиспользовать компоненты
- писать TypeScript
- не ломать архитектуру
- добавлять loading/error/empty states
- учитывать права доступа
- думать о масштабируемости IDE/authoring-среды для 1С

## Перед генерацией экрана Codex должен определить

1. Какая 1С-сущность или IDE-сущность?
2. Какие действия доступны пользователю?
3. Какие статусы есть?
4. Какие поля обязательные?
5. Нужен ли editor, designer, graph, table, inspector или diff?
6. Нужен ли AI Copilot?
7. Нужны ли права доступа?
8. Нужна ли история изменений?
9. Нужна ли интеграция с внешним источником?
10. Нужно ли preview/diff/apply для изменения 1С-кода или metadata?

## Запреты

Codex НЕ должен:
- использовать inline styles
- создавать хаотичные цвета
- использовать Bootstrap
- делать огромный компонент на 1000 строк
- хранить business logic в JSX
- игнорировать loading states
- игнорировать empty states
- генерировать mock API без явной пометки
- смешивать entity-компоненты и базовый UI

## Обязательные states

Каждый экран должен иметь:

- loading
- error
- empty
- success
- permission denied
- dirty form / unsaved changes
- semantic diff / preview
- guarded apply result

## UI quality checklist

Перед финалом Codex обязан проверить:

- интерфейс адаптивный
- все кнопки имеют понятный action
- статусы представлены Badge
- опасные действия требуют confirmation
- таблицы имеют фильтры
- формы валидируются через Zod
- редактор/дизайнер имеет problems panel и состояние несохранённых изменений
- дата/время форматируются единообразно
- AI действия показывают token/cost impact
- AI-подсказки учитывают текущий BSL-код, объект 1С, переменные, реквизиты, формы и связи
- есть audit trail для важных действий