55 lines
2.8 KiB
Markdown
55 lines
2.8 KiB
Markdown
# 15. Правила и ограничения платформы
|
||
|
||
## Назначение
|
||
Документ фиксирует обязательные ограничения платформы для всех команд: frontend, backend, QA, DevOps и интеграционных партнеров.
|
||
|
||
## Базовые неизменяемые принципы
|
||
- Платформа полностью configuration-driven.
|
||
- Никакой hardcoded tenant/project логики во frontend.
|
||
- Tenant определяется только по домену.
|
||
- UI строится из bootstrap.json.
|
||
- Виджеты переиспользуемы и не обращаются к API напрямую.
|
||
- Backend предоставляет данные, а не layout.
|
||
- Layout управляется только конфигурацией.
|
||
|
||
## Обязательные правила JSON-модульности
|
||
- Bootstrap: структура страниц и подключение систем.
|
||
- Theme JSON: только визуальные токены.
|
||
- Navigation JSON: только маршруты и меню.
|
||
- Catalog/Product/Category API JSON: только доменные данные.
|
||
- Запрещено смешивать зоны ответственности между JSON-модулями.
|
||
|
||
## Что разрешено
|
||
- Добавлять новые виджеты через registry/manifest.
|
||
- Расширять опциональные поля с сохранением обратной совместимости.
|
||
- Добавлять новые секции/страницы через конфигурацию.
|
||
|
||
## Что запрещено
|
||
- Хардкод tenant-веток в компонентах.
|
||
- Прямые API-вызовы из widget UI слоя.
|
||
- Дублирование layout-правил в каждом виджете.
|
||
- Breaking изменения контрактов без schemaVersion.
|
||
|
||
## Пример policy JSON
|
||
```json
|
||
{
|
||
"platformPolicy": {
|
||
"configurationDriven": true,
|
||
"tenantResolution": "domain-only",
|
||
"widgetsCanCallApiDirectly": false,
|
||
"layoutControlledBy": "configuration",
|
||
"backendProvides": ["products", "categories", "items"]
|
||
}
|
||
}
|
||
```
|
||
|
||
## Ответственность Frontend
|
||
- Соблюдать архитектурные ограничения и слоистость.
|
||
- Не вводить локальные обходы конфигурации.
|
||
- Проводить регрессионные проверки на multi-tenant сценариях.
|
||
|
||
## Ответственность Backend
|
||
- Строго следовать контрактам данных.
|
||
- Поддерживать tenant isolation и аудируемость изменений.
|
||
- Предоставлять стабильные и документированные API.
|