Верифіковані assets
10
2 bronze / 1 silver / 7 gold у MVP_DEMO_ASSETS
Week 1DAM / UAH / LP baselineCurrent MVP + target architecture
Interactive project report
Перший тиждень диплома, упакований як яскравий interactive report для керівника.
Це інтерактивний week 1 report, який збирає реальні repo-grounded метрики, чіткі формули, doi-посилання та цілісну narrative surface у світлому Sims-подібному стилі: багато синього, позитивний тон і чітке розділення між тим, що вже реалізовано, і тим, що лишається цільовою дослідницькою архітектурою.
Control-plane API
8
1 system / 1 tenants / 2 weather / 4 dashboard endpoint-и
Реальні джерела
3 + fallback
OREE, Open-Meteo, tenant registry і deterministic synthetic safety net
Research anchors
5
DOI-посилання, які прямо підтримують current scope і target architecture
Scope boundary
Поточний MVP і цільова дослідницька архітектура
Current output
Recommendation preview замість execution
Сьогоднішній deliverable — це projected SOC, baseline recommendation і control-plane explanation surface.
Battery layer
Feasibility-and-economics preview model
Battery logic already tracks SOC bounds, power bounds, round-trip efficiency і public-source capex-throughput degradation proxy в UAH.
Operator shell
Nuxt + FastAPI demo contour
Сторінка поєднує verified metrics, formulas, source provenance і current architecture boundary в єдину operator-facing narrative surface.
Dagster contour
MVP asset graph, який уже можна захищати словами й кодом
Це реальний Week 1 / Week 2 contour із `MVP_DEMO_ASSETS`: він уже має Bronze, Silver і Gold layers, а не лише намір їх створити пізніше.
Bronze2
weather_forecast_bronze, dam_price_history
Silver1
strict_similar_day_forecast
Gold7
metrics, telemetry, LP plan, gatekeeper, blocked demo, oracle metrics, MLflow tracking
FastAPI surface
Control-plane API уже досить широкий для demo-stage walkthrough
Цей графік відокремлює service health, tenant lookup, weather actions і dashboard read models. Саме така декомпозиція зручна для supervisor explanation, бо вона показує, що operator shell має зрозумілі межі.
System1
GET /health
Tenants1
GET /tenants
Weather2
POST /weather/run-config, POST /weather/materialize
Dashboard4
signal-preview, operator-status, projected-battery-state, baseline-lp-preview
Battery economics
Чому current degradation proxy прозорий, а не довільний
Поточна логіка не приховує, що вона спрощена. Але число вже не є placeholder: для demo battery воно виводиться як capex-throughput proxy з публічних assumptions, який можна детерміновано включити в LP objective і потім пояснити прямо на demo-слайді.
MC_deg = C_cycle / (2 * Capacity_mwh)
Penalty_t = MC_deg * Throughput_t
210 * 10,000 * 43.9129 / (15 * 365) = 16,843.3 UAH/cycle
16,843.3 / (2 * 10) = 842.2 UAH/MWh
Capex anchor210 USD/kWh
Visible battery-pack capex anchor from Grimaldi et al.
Lifetime15 years
NREL ATB fixed-O&M framing keeps rated capacity over a 15-year life.
Cycle pace~1 / day
Utility-scale default implies about 5,475 lifetime cycles.
FX anchor43.9129 UAH/USD
Official NBU rate dated 04.05.2026.
ELT walkthrough
Реальний data flow, який можна показати без натяжок
Tenant registry
Локація, timezone і tenant metadata приходять із YAML registry та API /tenants.
Bronze ingestion
Open-Meteo дає погодні hourly features, OREE накладає live price rows поверх synthetic DAM base.
Silver + Gold
strict similar-day forecast переходить у LP baseline, projected SOC preview і gatekeeper validation.
Operator surface
FastAPI повертає signal preview, operator status, projected battery state і baseline LP preview.
Source provenance
Джерела, які можна назвати поіменно і з URL
Live market source
OREE market rows
Live DAM rows накладаються поверх deterministic synthetic base для demo stability.
https://www.oree.com.ua/index.php/pricectr/data_viewLive weather source
Open-Meteo
Hourly weather features і solar-derived fields для tenant-aware weather slice.
https://api.open-meteo.com/v1/forecastConfigured local source
Tenant registry
Coordinates і timezone беруться з simulations/tenants.yml або fallback registry в самому репозиторії.
Public assumption source
NREL ATB utility-scale storage
Дає utility-scale LIB/LFP framing, 15-year lifetime, приблизно 1 cycle/day і 85% RTE для capex-throughput proxy.
https://atb.nrel.gov/electricity/2024/utility-scale_battery_storageOfficial FX source
NBU FX API
Офіційний курс USD/UAH 43.9129 на 04.05.2026 використовується для переведення capex proxy у UAH.
https://bank.gov.ua/NBUStatService/v1/statdirectory/exchange?valcode=USD&jsonResearch anchors
DOI-посилання, які прямо підтримують обрані архітектурні рішення
DOI
Yi et al. — Decision-Focused Predict-then-Bid
Обґрунтовує target architecture для переходу від baseline PTO до DFL-парадигми в energy arbitrage.
10.48550/arXiv.2505.01551DOI
Olivares et al. — NBEATSx for electricity prices
Підтримує вибір stronger forecast layer для наступного етапу після strict similar-day baseline.
10.1016/j.ijforecast.2022.03.001DOI
Jiang et al. — Penalized TFT price forecasting
Пояснює, чому TFT варто тримати як кандидат для weather-aware probabilistic forecasting.
10.1002/for.3084DOI
Elmachtoub and Grigas — Smart Predict, then Optimize
Дає канонічну точку відліку, чому baseline LP має лишатися контрольним контуром для майбутнього comparison.
10.1287/mnsc.2020.3922DOI
Grimaldi et al. — Arbitrage with degradation-aware optimization
Підкріплює тезу, що деградацію слід вносити прямо в objective; visible paper metadata також дає capex anchor 210 USD/kWh, але не готову універсальну UAH/cycle константу.
10.1016/j.est.2024.112380Clarifying notes
Ключові уточнення до поточної версії системи
Чому зараз використовується проста economic penalty за деградацію?Formula
MC_deg = C_cycle / (2 * Capacity_mwh) ; Penalty_t = MC_deg * Throughput_t
Це сумісно з LP-baseline, не руйнує контрольну постановку і вже дає оператору зрозумілий economic signal у UAH.
Число тепер теж є прозорим: для demo battery береться capex anchor 210 USD/kWh, NREL ATB assumptions 15 years і ~1 cycle/day, а потім усе переводиться в UAH за офіційним курсом НБУ.
Поточна модель свідомо не претендує на повний battery digital twin. Вона описує feasibility-and-economics preview model, достатню для MVP і першого walkthrough.
Як зараз реально працює data flow?Ready answer
Tenant metadata задає координати. Bronze layer збирає погоду і ринкові рядки. Silver формує strict similar-day forecast. Gold запускає LP baseline, projected SOC preview і gatekeeper validation.
На виході система повертає не real market execution, а recommendation preview, projected SOC trace і operator-facing read models.
Що таке missed value у поточній demo-surface?Formula
missed_value = max(80, weather_bias * 2.4 + abs(adjusted_price - avg_adjusted_price) * 0.45)
Це не settlement field і не LP objective. Це спрощений operator-facing opportunity score, який пояснює, чому певні години виглядають більш важливими у візуальному preview.
У stronger stack ця евристика має поступитися regret, policy value gap або іншій decision-quality metric.
Що важливо не overclaim-ити сьогодні ввечері?Ready answer
Поточний MVP не виконує bidding, clearing і реальний dispatch. Також він не містить повний digital twin батареї та не реалізує DFL end-to-end.
Правильне формулювання: є working baseline contour, control-plane API, operator-facing dashboard surface і чітка research trajectory до DFL.