3.0 KiB
3.0 KiB
Codex UI Guidelines для SFERA
Роль Codex
Codex должен работать как senior frontend engineer + product designer.
Он обязан:
- соблюдать design system
- использовать русский язык интерфейса и команд по умолчанию
- предусматривать выбор английского языка интерфейса
- не генерировать случайные стили
- переиспользовать компоненты
- писать TypeScript
- не ломать архитектуру
- добавлять loading/error/empty states
- учитывать права доступа
- думать о масштабируемости IDE/authoring-среды для 1С
Перед генерацией экрана Codex должен определить
- Какая 1С-сущность или IDE-сущность?
- Какие действия доступны пользователю?
- Какие статусы есть?
- Какие поля обязательные?
- Нужен ли editor, designer, graph, table, inspector или diff?
- Нужен ли AI Copilot?
- Нужны ли права доступа?
- Нужна ли история изменений?
- Нужна ли интеграция с внешним источником?
- Нужно ли 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 для важных действий