Initial SFERA platform baseline

docs/codex-ui-guidelines.md

@@ -0,0 +1,72 @@
+# 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 для важных действий