# Valvix Energy: ТЗ на дизайн Версія 2 (2026-11-20). Центральна сторінка: https://v-energy.preview.sif.titanium.team Над дизайном паралельно працюють різні чати й моделі, і кожен пропонує **своє бачення**. ТЗ дає мету й матеріал, а форму, стиль, структуру й набір екранів обирає дизайнер. Жорстких вимог небагато: «Вхід» і «Заявка на підключення» (розд. 3), «Чесні цифри» (розд. 5) і «Як здати роботу» (розд. 7). ## 1. Що це Valvix Energy керує енергетикою об'єкта напряму, за секунди, і так, як вирішив власник. Під керуванням — інвертори, батареї, генератори, лічильники, розетки, нагрівачі, компресори й насоси. - **Локально й швидко.** Модуль стоїть на об'єкті й говорить з пристроями напряму, цикл — 2 с. Без інтернету працює так само. - **Правила власника людською мовою.** Кожна дія має причину. Порядок старшинства: захист > ручне керування > план. - **Будь-яка мережа.** Хата, фруктосховище й станція на мегавати описуються одним файлом об'єкта. - **Home Assistant — партнер.** HA показує дані й дає доступ до пристроїв, до яких модуль не дістає напряму. Рішення приймає Valvix. ## 2. Для кого | Хто | Що болить | Що Valvix дає | |---|---|---| | Дім, садиба з СЕС, батареєю, генератором | блекаути; СЕС обрізається; ввечері порожня батарея | острів без помітного вимкнення; надлишок іде в тепло, а не обрізається | | Агробізнес: фруктосховища, теплиці, полив, сушарки | великі навантаження, пікова ціна, ліміт приєднання | процес (холод, клімат) не страждає, енергія дешевшає | | Генерація на продаж: вода, вітер, сонце | ліміт експорту, погодинна ціна, вимоги диспетчера | різні джерела й марки працюють як одна станція впритул до межі | | Громада: село, котеджне містечко, ОСББ, кооператив, об'єкт з багатьма будинками | одна лінія чи трансформатор на всіх; блекаут | багато будинків і джерел як одне ціле; черга пріоритетів | | Інсталятори й сервісні компанії | десятки об'єктів, і кожен окремо | усі об'єкти на одній карті | | Власники Home Assistant | автоматизації повільні й крихкі | розумний модуль поруч з HA | ## 3. Що має вийти Людина, яка нічого не знає про енергетику, за хвилину бачить, як Valvix керує її об'єктом, і хоче таке собі. «Вау» має бути від того, що видно, як воно працює, а не від гарної картинки. Що варто показати (як саме — вирішуєш ти): - **Рух енергії:** звідки, куди, скільки. Енергії не видно — дизайн має зробити її видимою. - **Рішення з причиною:** що Valvix зробив і за яким правилом власника. - **Межу:** ліміт приєднання чи трансформатора, коридор температури продукту — і як Valvix тримає роботу впритул. - **Різні масштаби:** дім, бізнес, генерацію, громаду. - **Час:** як рішення змінюються з сонцем, хмарою, вітром, ціною, блекаутом. Наприклад, через «прокрутку доби». - **Різницю «без Valvix / з Valvix»** — чесно, на демо-даних. - **Home Assistant** — хоча б як ідею: як модуль живе поруч з HA. Обов'язково є (вигляд і місце — на твій вибір): - **«Вхід».** Його видно з будь-якої сторінки. Він веде в кабінет власника, де той бачить і керує своїм об'єктом (чи кількома). Справжньої адреси кабінету ще немає, тож намалюй екран входу сам. - **«Заявка на підключення».** Головна дія для нового клієнта, до неї ведуть усі сторінки й приклади. Форма коротка: - хто ви: дім, бізнес, генерація, громада, інсталятор; - що вже стоїть: інвертори, батарея, генератор, потужність СЕС чи інших джерел; - що болить і чого хочете; - область або місто; - як зв'язатися: ім'я, телефон, Telegram або e-mail. Можна запропонувати додати фото екранів інвертора чи схеми. Після надсилання людина бачить, що буде далі. У прототипі форма нічого нікуди не надсилає і показує лише підтвердження. Можливі підходи: жива схема потоків, вигляд згори як на карті, доба як головний герой — або щось зовсім інше. Набір сторінок теж твій: лендінг, інтерактивне демо, екрани кабінету, телефон, картки HA. Одна жива сторінка, на якій усе видно, сильніша за десять статичних. Орієнтир рівня — «Карта ферми» на сайті Valvix: https://valvix.preview.sif.titanium.team/map/mixed (код: `/srv/work/my/valvix/site/web/public/design/farm-map/`). ## 4. Матеріал для прикладів Нижче — ідеї з правдоподібними цифрами. Бери, змінюй, додавай свої. **Дім, садиба.** Гібрид з батареєю 16 кВт·год, панелі на даху й друга СЕС у полі. Навантаження: обігрівачі, бойлер, тепла підлога, насос свердловини, електромобіль. Події — зі справжніх правил хати власника: - **Надлишок сонця.** СЕС не обрізається: обігрівачі й бойлер вмикаються по черзі, не частіше ніж раз на 5 хв. - **Хмара.** Виробіток падає на 70 % за хвилину, навантаження знято за 2 с, батарею не чіпаємо. - **2 год до заходу.** Нових обігрівачів не вмикаю, доливаю батарею до 98 %. - **19:40, мережа зникла.** Дім на острові, СЕС під стелею 6 кВт, ніхто нічого не помітив. - **Мережа повернулась.** СЕС додаю лише тоді, коли гібрид справді підключився. **Фруктосховище.** Перший реальний клієнт — невеликий: СЕС 100–300 кВт на даху, а холод бере 120–170 кВт. Камери з яблуками, компресори. Головне правило: продукт важливіший за гроші, температура не виходить з коридору. Камера працює як батарея: холод запасаємо, коли є сонце, і віддаємо, коли енергія дорога. - **Полудень.** Сонце дає 280 кВт, холод бере 140. Решту не продаємо за копійки: камери переохолоджуємо на 0,4 °C у межах коридору. - **Вечірній пік ціни.** Компресори відпочивають, температура повільно повзе вгору в межах коридору. - **Ніч, дешевий тариф.** Відтавання випарників і добір холоду. - **Двері камери 7 відчинені 15 хв.** Сповіщення команді. Ширше: великі сховища на мегават, овочесховища, шокова заморозка ягід. **Генерація на продаж: вода, вітер і сонце разом.** Долина з річкою: міні-ГЕС з водосховищем, вітряки на пагорбі, сонячне поле на схилі, одна точка приєднання з межею. Три джерела доповнюють одне одного: сонце дає вдень, вітер — частіше вночі й узимку, а вода гнучка, бо водосховище — це батарея. Орієнтовно: ГЕС 0,8 МВт, вітер 2 × 2,5 МВт, СЕС 3 МВт, приєднання 5 МВт. - **11:00.** Сонце й вітер разом дають більше, ніж дозволяє межа. ГЕС прикриває затвори, вода чекає у водосховищі, нічого не обрізається. - **13:00.** Ціна впала до мінімуму. Продаж мінімальний, водосховище набирається. - **18:00–21:00, пік ціни.** ГЕС на повну, вітер додає, водосховище спрацьовується. - **02:00, шторм.** Вітряки переходять у штормовий режим, ГЕС підхоплює. - **Диспетчер просить −2 МВт.** Виконано за 2 с, станція не зупинялась. - **Рахунок доби.** Продано МВт·год, середня ціна, скільки не викинули. **Теплиці.** Когенераційна установка (струм + тепло), теплові акумулятори, котел, досвічування, СЕС. Головне правило: клімат у теплиці не виходить з коридору. На піку когенерація продає в мережу, а тепло йде в бак; уночі тепло беремо з бака, котел не вмикається. **Громада, село.** 60 будинків, школа, амбулаторія, водонапірна башта. Джерела: СЕС на школі й у полі, міні-ГЕС або біогаз, спільна батарея. Межа трансформатора — 400 кВА. - **Вдень надлишок.** Батарея заряджається, вода качається в башту (вода — теж батарея). - **Блекаут.** Село на острові. Порядок: амбулаторія → вода → школа → будинки, по черзі. **Ще ідеї:** полив і насосні станції, зерносушарки, ферми з біогазом, портфель інсталятора з десятками об'єктів. ## 5. Чесні цифри (обов'язково) - Демо-дані правдоподібні й виглядають як живі показники: кВт, кВт·год, %, °C, ₴ або $. - Маркетингових відсотків і обіцянок не вигадуємо. Економію рахуємо лише в межах демо-доби й підписуємо «демо». - Марки — лише текстом і лише ті, з якими модуль працює або точно працюватиме: Deye, Fronius, Solis, Tuya, ESPHome, Home Assistant. Логотипів виробників не показуємо. - Жодних справжніх адрес, прізвищ, IP чи ключів з хати власника. ## 6. Бренд і матеріали - **Лого:** `assets/brand/valvix-energy-charge.svg` (на центральній сторінці — `/brand/valvix-energy-charge.svg`). Кольори: лайм `#B4F55D`, світлий `#F6F8EF`. - **Стиль сайту Valvix** — темний `#0a0f0b`, лайм, Inter + Playfair Display italic. Його можна продовжити, а можна запропонувати своє, якщо поясниш чому. - **Як керує справжня хата:** `README.md` цього репозиторію й `src/valvix_energy/blocks/core/island.py`. - **Мова:** українська обов'язкова, англійська — плюс (компанія виходить і на США). - **Пристрої й якість:** телефон (390 px) і ноутбук (1440 px), без горизонтального скролу й помилок у консолі. ## 7. Як здати роботу (обов'язково) Усі варіанти збираються на одній центральній сторінці: https://v-energy.preview.sif.titanium.team. Вона сама знаходить нові теки й оновлюється кожні 30 с, тож Nick бачить, що де робиться. 1. **Перш ніж почати, подивись центральну сторінку.** Що вже є? Не повторюй чужий підхід — запропонуй інший. 2. **Зареєструйся одразу, ще до дизайну.** Створи теку `design/variants//` у `/srv/work/my/valvix/energy`. `` — латиницею, малі літери й дефіс, наприклад `zhyva-skhema`, і такої теки ще не має бути. Поклади туди `entry.json` зі статусом `working`. 3. **Що лежить у теці:** - `entry.json` — картка на центральній сторінці (формат нижче); - `index.html` — головна сторінка дизайну (або зовнішня адреса в полі `open`); - `LOGIC.md` — твоя логіка: ідея, чому так, як показано продукт, що зроблено, що далі, питання до Nick; - `cover.png` — знімок головного екрана 1200×750, коли буде що показати. 4. **Оновлюй `entry.json` по ходу.** Після кожного помітного кроку — `updated`, `status` і новий рядок у `notes`. 5. **Працюй лише у своїй теці.** Не чіпай центральну сторінку, це ТЗ і чужі теки. Інших клонів і worktree не створюй. Комітити — лише свою теку й лише коли Nick скаже. ```json { "title": "Жива схема", "author": "Fable 5.2 · чат «S. Енергетика — жива схема»", "status": "working", "created": "2026-11-20T18:00:00+02:00", "updated": "2026-11-20T18:40:00+02:00", "summary": "Одне-два речення: у чому ідея.", "open": "index.html", "logic": "LOGIC.md", "cover": "cover.png", "pages": [{ "title": "Демо: дім", "href": "index.html?site=home" }], "notes": [{ "at": "2026-11-20T18:40:00+02:00", "text": "Готовий сценарій «Дім»" }] } ``` Статуси: `working` — у роботі; `ready` — можна дивитись; `question` — потрібна відповідь Nick (саме питання пиши в `LOGIC.md`). **Перевірка.** Твій варіант видно на Sindri за адресою `http://127.0.0.1:1370/variants//`, а публічно — на центральній сторінці. Знімки екрана роби Playwright з образу `sobaken-planner-browser:local` з `--network host` (шаблон — у `/srv/work/my/valvix/site/docs/design/landing-v2-brief.md`). Переглянь кожен знімок, перш ніж ставити `ready`. ## 8. Відкриті питання до Nick 1. **Де житиме публічна частина:** розділ `valvix.ai/energy` чи окремий сайт? 2. **Чи можна взяти хату власника за основу прикладу «Дім»** (без адреси, цифри округлені)? 3. **Модуль для Home Assistant:** безкоштовний, платний чи «для дому безкоштовно, для бізнесу платно»?