ТЗ DECOR — стеклянные крыши / веранда

Проект: админка и интерфейс оператора приёма заказов для стеклянных крыш / веранд / пергол. Сгенерировано: 2026-02-26 12:15.

ТЗ сформировано на основе: 1) страницы GARDECOR для категории стеклянных крыш/веранд (каталог/лид-форма/консультация/showroom/contact, best-effort из открытых snippets), 2) материалов decor/docs/veranda (PDF + 2 XLSX: прайс материалов и производственная калькуляция), 3) shell-концепции и паттерна модулей credit / nufarul в текущем проекте Artgranit.

Рабочие интерфейсы

Реализованы внутри платформы UNA shell как отдельный модуль DECOR.

DECOR Оператор DECOR Админка

Материалы / HTML-конверсии

Ключевая идея

Оператор в зале быстро вводит параметры изделия (габариты, стекло, LED, опции), получает расчёт сметы и сохраняет заявку/заказ. Администратор управляет справочником материалов, коэффициентами расчёта, статусами заказов и отчётностью.

1. Предметная область (по материалам veranda)

Прайс профилей и аксессуаров HUUN Veranda: листы PROFILE (NEW SYSTEM), ACCESSORY (2).
Производственная калькуляция veranda (турецкий шаблон): типы стекла TEKCAM / ISICAM, размеры (ширина/вылет/высоты), LED / RGB / dimmer, листы себестоимости и спецификации.
Категории материалов: профили, аксессуары, стекло, водоотвод, монтаж, опции LED.
Тип заказа: индивидуальный проект с параметрами, а не стандартная товарная корзина.

2. Роли пользователей

Роль	Назначение	Функции
Оператор приёма	Работа в шоуруме / в зале	Ввод параметров изделия, расчёт сметы, оформление заявки/заказа, поиск по номеру, просмотр последних заказов
Администратор	Поддержка справочников и расчётной модели	Материалы, коэффициенты (маржа/отходы/ставки), список заказов, смена статусов, отчёт по дням

3. Функциональные требования

3.1 Оператор (зал)

Форма параметров: тип проекта, тип системы (TEKCAM/ISICAM), цвет, ширина/вылет, передняя/задняя высоты, LED-опция.
Опции включения в смету: водоотвод, транспорт, монтаж.
Кнопка расчёта сметы с отображением: площадь, периметр, уклон, строки сметы, итог в USD и MDL.
Карточка клиента: имя, телефон, email, адрес/локация, примечание.
Сохранение заказа/лида с автогенерацией номера формата DEC-YYYYMM-NNNNN.
Поиск заказа по номеру/штрихкоду, список последних заказов.

3.2 Админка

Справочник материалов: CRUD (код, название, категория, единица, цена, валюта, источник: файл/лист, активность).
Настройки расчёта: курсы валют, маржа, отходы, ставки на стекло, монтаж, транспорт, LED-опции, списки типов/цветов.
Список заказов с фильтрами по статусу/периоду/поиску.
Смена статуса заказа (лид, смета отправлена, согласовано, производство, монтаж, завершено, отменено).
Отчёт по дням: количество заказов и сумма.

4. Расчётная модель (MVP)

Расчёт реализован как конфигурируемая оценочная модель (не заменяет инженерный production-калькулятор из XLSX, но даёт быстрый коммерческий расчёт для оператора).

Площадь: ширина × вылет (в м²).
Периметр: используется для LED white per meter.
Уклон: вычисляется из разницы высот (rear - front) и вылета.
Себестоимость: стекло + профиль (оценка) + аксессуары + водоотвод + LED + монтаж + транспорт.
Коммерция: тех. отходы (%) + маржа (%).
Валюты: итог в USD и пересчёт в MDL по настраиваемому курсу.

5. Техническая реализация (в рамках shell-концепции)

Платформа: Flask-приложение текущего проекта Artgranit.
Маршруты UI: /UNA.md/orasldev/decor-operator, /UNA.md/orasldev/decor-admin.
Маршруты docs: /UNA.md/orasldev/docs/decor/ + HTML-файлы из docs/DECOR.
API:
- /api/decor-operator/catalog, /api/decor-operator/calculate, /api/decor-operator/order, /api/decor-operator/recent-orders, /api/decor-operator/order-by-number
- /api/decor-admin/materials, /api/decor-admin/settings, /api/decor-admin/statuses, /api/decor-admin/orders, /api/decor-admin/orders/<id>/status, /api/decor-admin/report-by-day
Хранилище MVP: локальный JSON data/decor_store.json (fallback без Oracle-таблиц/контроллеров).

6. Конвертированные материалы veranda (HTML)

huun_new_veranda_material_base_price_list_2024.html — HUUN- NEW VERANDA- Material Base Price List -2024.xlsx (xlsx)
veranda.html — Veranda.pdf (pdf)
yeni_veranda_u_reti_m_mali_yet_hesaplama.html — YENİ VERANDA ÜRETİM MALİYET HESAPLAMA.xlsx (xlsx)

6.1 Все HTML-файлы в docs/DECOR (включая поддиректории)

7. Ограничения и дальнейшие шаги

Текущий расчёт — коммерческий MVP; для инженерной точности нужна более глубокая интеграция с логикой XLSX (формулы/все коэффициенты).
PDF Veranda.pdf конвертирован в HTML-обёртку best-effort без OCR/профильных библиотек.
Для shell-списка проектов (/una.md/shell/projects) может потребоваться запись в таблицу UNA_SHELL_PROJECTS.

DECOR — Техническое задание