73 lines
3.0 KiB
Markdown
73 lines
3.0 KiB
Markdown
# 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 для важных действий
|