крива до дедлайну замість чотирьох точок

«Крива капіталу» малювала лінію по тих самих 1/3/5/10 роках, що й таблиця
під нею. Вона казала, ЧИМ усе скінчиться, і мовчала про те, коли саме
траєкторія розходиться з планом. А розходиться вона нерівномірно: перші
роки будуються з фактичного календаря виплат, тож мають форму, якої в
сухому складному відсотку немає.

Нова domain.ProjectSleevesSeries — та сама симуляція, але з відліком на
кожному кроці. Рукави крокують у лок-степі, як у MonthsToReachSleeves і з
тієї самої причини: підсумок береться по всіх валютах разом, і кожна
мусить бути на тому самому місяці. Одна симуляція на сценарій — чотири
разом, а не перезапуск на кожну точку.

Дві угоди записані в коді як умови, а не як побажання. Точка на нулі є
завжди (крива, що починається з першого кроку, візуально стрибає від
нуля, і читач бачить приріст, якого не було). Остання точка завжди
дорівнює горизонту, навіть якщо крок туди не влучає — інакше кінець кривої
розходився б із сумою, яку та сама модель називає в картці прогнозу.

Крок росте з горизонтом, щоб точок лишалось близько дюжини. Помісячна
крива на десяти роках це 120 точок на серію, тобто півтисячі чисел у
документі заради лінії, у якій сусідні місяці візуально не відрізняються;
документ читає ще й Home Assistant.

Заразом scenarioDef піднято на рівень пакета: набори допущень віяла тепер
проганяє ще й крива, і перелічувати їх удруге означало б завести другий
шанс розійтись — той самий, який уже коштував нам двох визначень капіталу.

У charts.js новий svgBandLine. Окремо від svgLine навмисно: той малює
рівноправні серії, а тут у серій РІЗНІ ролі — дві задають межі коридору,
третя йде посередині, четверта показує відхилення, а ціль це взагалі не
серія. Запхати ролі в svgLine означало б додати йому чотири прапорці й
зламати два наявні виклики. Ціль входить у масштаб: інакше її лінія
вилітала б за полотно, і «не дотягуємо» виглядало б як «дотягуємо».

Картка лишає запасний вигляд на чотирьох точках: старі бекенди кривої не
надсилають, і панель не мусить показувати порожньо.

ЗМІНА GOLDEN — доданий forecast.curve: 14 точок кроком 3 місяці на
39-місячному горизонті. Жодне наявне число не зрушило.

Сторожі. У домені пʼять, головний — кінець кривої дорівнює тому, що на
тому ж горизонті дає ProjectSleeves, і перевіряється на пʼятьох різних
горизонтах. Це дві реалізації однієї моделі, і на екрані вони стоять
поруч: крива веде до числа, яке картка називає словами.

У фазі два: кінець кривої збігається з УСІМА чотирма рядками прогнозу
(збіг одного буває випадковим — сценарії відрізняються лише допущеннями,
і легко зібрати криву для одного набору, а підпис узяти з іншого), і
розмір документа не росте помісячно.

Мутаційно перевірено чотири злами: кінець не додається, коли крок не
влучає; крива починається з першого кроку; всі сценарії рахуються від
реалістичних допущень; крок завжди 1.

Наживо на копії: картку відмальовано тим самим модулем, що й у браузері
(node імпортує views/future.js і отримує справжній документ) — коридор,
пунктир факту, лінія цілі й підписи років на місці.

Author: ODDsama

contract/oddinvest-state.schema.json

@@ -712,6 +712,28 @@
         "contrib_plan": { "type": "number" },
         "rate0_usd": { "type": "number" },
         "glide_years": { "type": "number" },
+        "curve": {
+          "type": "object",
+          "description": "Та сама модель помісячно: рядки кажуть, ЧИМ усе скінчиться, крива — коли саме траєкторія розходиться з планом (адитивне поле)",
+          "properties": {
+            "step_months": { "type": "integer", "minimum": 1, "description": "Крок між точками; росте з горизонтом, щоб точок лишалось близько дюжини" },
+            "goal_uah": { "type": "number", "description": "Лінія цілі, щоб UI не діставав її з іншого місця" },
+            "points": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "month": { "type": "integer", "minimum": 0, "description": "Місяць від сьогодні; 0 — сьогоднішній капітал" },
+                  "plan": { "type": "number", "description": "Реалістичний сценарій, у сьогоднішніх ₴" },
+                  "optimistic": { "type": "number" },
+                  "pessimistic": { "type": "number" },
+                  "actual": { "type": "number", "description": "За фактичним темпом поповнень; відсутнє, поки темп невідомий" }
+                },
+                "required": ["month", "plan"]
+              }
+            }
+          }
+        },
         "rows": {
           "type": "array",
           "items": { "type": "object" }

contract/ui-manifest.json

@@ -7,21 +7,21 @@
     { "path": "css/theme-web.css", "sha256": "c715fb6ccbd354b01a8d55b052a4c161b49c8f46756ecef2e97dd9e6a0e43b99" },
     { "path": "css/tokens.css", "sha256": "7f40aebc154d1e549f8d12afd17269dbe0a15dfa1367e1205eacfb05120d7a8c" },
     { "path": "js/app.js", "sha256": "0f8fa1b03887ffe3148ac4993795fe3661f263fb2a09f741a214592d56286a01" },
-    { "path": "js/charts.js", "sha256": "f7ac8dbca1ce57b3dfcfcf940a53f218fae4da1b0dbf5afe9d0cc3e8c1e5ad11" },
+    { "path": "js/charts.js", "sha256": "7c511649c89975b263af293d63a0657481b3c0203f08c3f135f215933fc519ea" },
     { "path": "js/components.js", "sha256": "2116cd17793ed795998bde2bf274b57fc63f5a7c8f2666a70a7ccf52454389e9" },
     { "path": "js/constants.js", "sha256": "6e1e88eeaed650d6f8db8c1edda6f95180afad53ce8fb1b04c862d39b7ecf28f" },
     { "path": "js/disclosure.js", "sha256": "28a4313a71fd15a0b12b45695928f4edd16a314afb69ff731ff22a7b4c98dfef" },
     { "path": "js/format.js", "sha256": "ebf4800d3d52b3154cbd937b228bd2f4f16975e83620b9ed096ee29380592491" },
     { "path": "js/forms.js", "sha256": "971f334403306920b57241636faec6e25121a127f838282333cac9c0d7d28efd" },
     { "path": "js/fund-ops.js", "sha256": "7efc8885a39a054655824315840bba89c6a60ed6ce0c1c597902fe100858c79b" },
-    { "path": "js/info.js", "sha256": "e6da3f6bff4afccd1cceb864050b93fbe1cc490d3613135ead3b8b7742865524" },
+    { "path": "js/info.js", "sha256": "9583bc6c6d29ad57799b54ca037943533a71f65b8e9e93ad7c89809dddd2efec" },
     { "path": "js/store.js", "sha256": "58f81bbb8262d47856790206066f557b871169e25eea268c2bc34598ba03e120" },
     { "path": "js/styles.js", "sha256": "7f623a4506b4336538ffce25d56eeab347afb912ceacadf76b8cdc05028f943f" },
     { "path": "js/transport.js", "sha256": "7be0b7f7ea8317446ce769fc30c95d8bd281adfdcd67d8dc2350a8b6c96b52ae" },
     { "path": "js/views/bonds.js", "sha256": "cbf6d03bc97ed22f21b58bad7dc52cfd072a844c9c139a154b4784452c43d32a" },
     { "path": "js/views/deposits.js", "sha256": "91b3d789c53293885b994ea44e63bba6f726591d08db09177d28b2b4b75e4bca" },
     { "path": "js/views/forecast.js", "sha256": "684c87ac6ea0e92f82fd0cd45cdb1cd88f329d23c967c4eced00dae8e0f6bdd7" },
-    { "path": "js/views/future.js", "sha256": "a2b2a3a03090e85d43953183daef486f79fdb277272049d6d173efdd6ddc0538" },
+    { "path": "js/views/future.js", "sha256": "431b72f6c3db1ee602db88d5addd89ae6b0239c15c1e7d2ecebe38bf638db2c7" },
     { "path": "js/views/history.js", "sha256": "6e6efb9e2221e78cbd2274990c8039348c29cd35ddc3204fead0969cdbc08545" },
     { "path": "js/views/money.js", "sha256": "63a25e448969cf90472f81cbe36e01b58fbfcb4d68842f1c9575faedc98eec7e" },
     { "path": "js/views/overview.js", "sha256": "38799ae16da85dcf1c243c462c485039c90b7eb7f1b830f0602e507ce01327e6" },

internal/api/state_projection.go

@@ -39,6 +39,17 @@ const (
 	defaultDevalSpreadPP = 4.0
 )
 
+// scenarioDef — один набір допущень віяла: що вносимо і який ринок.
+//
+// Тип рівня пакета, а не локальний, бо ті самі набори проганяє ще й
+// крива (buildForecastCurve). Доти він жив усередині функції, і крива
+// мусила б їх перелічити вдруге — з тим самим шансом розійтись, який уже
+// коштував нам двох визначень капіталу.
+type scenarioDef struct {
+	key, label             string
+	contrib, ratePP, deval float64
+}
+
 // projectionInput — усе, від чого залежить проєкція.
 //
 // Перелік довгий, і це не вада, а те, заради чого фаза виділена: він
@@ -395,17 +406,13 @@ func buildProjection(in projectionInput) projectionPhase {
 	if deadlineMonths <= 0 {
 		return out
 	}
-	type scenario struct {
-		key, label             string
-		contrib, ratePP, deval float64
-	}
-	defs := []scenario{
+	defs := []scenarioDef{
 		{"optimistic", "Оптимістично", out.ContribM, rateSpreadPP, math.Max(0, in.Deval-devalSpreadPP)},
 		{"realistic", "Реалістично", out.ContribM, 0, in.Deval},
 		{"pessimistic", "Песимістично", out.ContribM, -rateSpreadPP, in.Deval + devalSpreadPP},
 	}
 	if in.ActualMonthly > 0 {
-		defs = append(defs, scenario{"actual", "За фактом", in.ActualMonthly, 0, in.Deval})
+		defs = append(defs, scenarioDef{"actual", "За фактом", in.ActualMonthly, 0, in.Deval})
 	}
 	f := &state.Forecast{
 		Date:        string(domain.NewDate(today.Time().AddDate(0, deadlineMonths, 0))),
@@ -452,6 +459,56 @@ func buildProjection(in projectionInput) projectionPhase {
 		}
 		f.Rows = append(f.Rows, row)
 	}
+	f.Curve = buildForecastCurve(factory, defs, in.Deval, goalAmount, deadlineMonths)
 	out.Forecast = f
 	return out
 }
+
+// buildForecastCurve — помісячна траєкторія кожного сценарію.
+//
+// Одна симуляція на сценарій, тобто чотири разом: ProjectSleevesSeries
+// проходить місяці один раз і віддає зрізи, а не перезапускається на
+// кожну точку.
+//
+// Крок підбирається так, щоб точок було близько дюжини. Помісячна крива
+// на десятирічному горизонті — це 120 точок на серію, тобто півтисячі
+// чисел у документі заради лінії, у якій сусідні місяці візуально не
+// відрізняються.
+func buildForecastCurve(factory sleeveFactory, defs []scenarioDef,
+	deval, goal float64, months int) *state.ForecastCurve {
+	if months <= 0 {
+		return nil
+	}
+	step := months / 12
+	if step < 1 {
+		step = 1
+	}
+	// Ключ сценарію → зрізи. Місяці в усіх однакові, бо крок і горизонт
+	// одні; збирати їх у точки можна за індексом.
+	series := map[string][]domain.SeriesPoint{}
+	for _, d := range defs {
+		series[d.key] = domain.ProjectSleevesSeries(
+			factory.build(d.contrib, d.ratePP), d.deval, months, step)
+	}
+	plan := series["realistic"]
+	if len(plan) == 0 {
+		return nil
+	}
+	at := func(key string, i int) float64 {
+		s := series[key]
+		if i >= len(s) {
+			return 0
+		}
+		return round2(s[i].UAH)
+	}
+	out := &state.ForecastCurve{StepMonths: step, GoalUAH: goal}
+	for i, p := range plan {
+		out.Points = append(out.Points, state.ForecastCurvePoint{
+			Month: p.Month, Plan: round2(p.UAH),
+			Optimistic:  at("optimistic", i),
+			Pessimistic: at("pessimistic", i),
+			Actual:      at("actual", i),
+		})
+	}
+	return out
+}

internal/api/state_projection_test.go

@@ -94,6 +94,68 @@ func TestForecastSpreadDefaultsMatchOldConstants(t *testing.T) {
 	}
 }
 
+// TestForecastCurveEndsAtScenarioAmounts — кінець кривої дорівнює сумі
+// того самого сценарію в рядках прогнозу.
+//
+// Це два числа про одне й те саме на одному екрані: рядок каже «на
+// дедлайн буде X», крива веде туди лінією. Розійтись їм не можна —
+// читач побачив би лінію, яка закінчується не там, де написано.
+//
+// Перевіряються ВСІ чотири сценарії. Збіг одного буває випадковим:
+// сценарії відрізняються лише допущеннями, і легко зібрати криву для
+// одного набору, а підпис узяти з іншого.
+func TestForecastCurveEndsAtScenarioAmounts(t *testing.T) {
+	in := forecastInput(t, goalSettings("", "2030-01-01"))
+	in.ActualMonthly = 12_000
+	f := buildProjection(in).Forecast
+	if f == nil || f.Curve == nil || len(f.Curve.Points) == 0 {
+		t.Fatal("кривої немає")
+	}
+	last := f.Curve.Points[len(f.Curve.Points)-1]
+	if last.Month != f.Months {
+		t.Errorf("крива обривається на місяці %d, а дедлайн на %d", last.Month, f.Months)
+	}
+	byKey := map[string]float64{}
+	for _, r := range f.Rows {
+		byKey[r.Key] = r.Amount
+	}
+	for _, c := range []struct {
+		key  string
+		curv float64
+	}{
+		{"realistic", last.Plan},
+		{"optimistic", last.Optimistic},
+		{"pessimistic", last.Pessimistic},
+		{"actual", last.Actual},
+	} {
+		if want, ok := byKey[c.key]; ok && want != c.curv {
+			t.Errorf("%s: рядок каже %v, крива веде до %v", c.key, want, c.curv)
+		}
+	}
+	// Ціль лежить у самій кривій, щоб UI не діставав її з іншого місця й
+	// не малював лінію проти числа, якого в цьому ж обʼєкті немає.
+	if f.Curve.GoalUAH != f.GoalAmount {
+		t.Errorf("ціль у кривій %v, а в прогнозі %v", f.Curve.GoalUAH, f.GoalAmount)
+	}
+}
+
+// TestForecastCurveStaysSmall — точок близько дюжини, а не помісячно.
+//
+// Помісячна крива на десятирічному горизонті це 120 точок на серію,
+// тобто півтисячі чисел у документі заради лінії, у якій сусідні місяці
+// візуально не відрізняються. Документ читає ще й Home Assistant.
+func TestForecastCurveStaysSmall(t *testing.T) {
+	in := forecastInput(t, goalSettings("", "2036-07-01")) // ~10 років
+	f := buildProjection(in).Forecast
+	if f.Curve == nil {
+		t.Fatal("кривої немає")
+	}
+	if n := len(f.Curve.Points); n > 16 {
+		t.Errorf("точок %d за %d місяців — крок мусить рости з горизонтом",
+			n, f.Months)
+	}
+}
+
 // TestForecastWiderSpreadWidensFan — більший розкид розводить сценарії
 // далі один від одного. Напрямок, а не конкретні числа: конкретні
 // стереже golden.

internal/api/testdata/state_rich.json

@@ -684,7 +684,111 @@
           }
         ]
       }
-    ]
+    ],
+    "curve": {
+      "step_months": 3,
+      "goal_uah": 4000000,
+      "points": [
+        {
+          "month": 0,
+          "plan": 874996.99,
+          "optimistic": 874996.99,
+          "pessimistic": 874996.99,
+          "actual": 874996.99
+        },
+        {
+          "month": 3,
+          "plan": 1132780.51,
+          "optimistic": 1140845.85,
+          "pessimistic": 1125088.63,
+          "actual": 1062250.65
+        },
+        {
+          "month": 6,
+          "plan": 1391825.24,
+          "optimistic": 1412479.28,
+          "pessimistic": 1372356.62,
+          "actual": 1251880.5
+        },
+        {
+          "month": 9,
+          "plan": 1643396.9,
+          "optimistic": 1681274.51,
+          "pessimistic": 1608117.47,
+          "actual": 1435083.04
+        },
+        {
+          "month": 12,
+          "plan": 1891506.46,
+          "optimistic": 1951516.84,
+          "pessimistic": 1836309.56,
+          "actual": 1615807.66
+        },
+        {
+          "month": 15,
+          "plan": 2134979.75,
+          "optimistic": 2222111.09,
+          "pessimistic": 2055841.75,
+          "actual": 1792822.59
+        },
+        {
+          "month": 18,
+          "plan": 2375580.7,
+          "optimistic": 2495014.11,
+          "pessimistic": 2268481.56,
+          "actual": 1967838.09
+        },
+        {
+          "month": 21,
+          "plan": 2613598.4,
+          "optimistic": 2770733.65,
+          "pessimistic": 2474507.01,
+          "actual": 2141077.63
+        },
+        {
+          "month": 24,
+          "plan": 2849306.38,
+          "optimistic": 3049776.54,
+          "pessimistic": 2674172.81,
+          "actual": 2312764.49
+        },
+        {
+          "month": 27,
+          "plan": 3082872.39,
+          "optimistic": 3332670.56,
+          "pessimistic": 2867621.47,
+          "actual": 2482987.19
+        },
+        {
+          "month": 30,
+          "plan": 3314628.3,
+          "optimistic": 3620292.07,
+          "pessimistic": 3055107.06,
+          "actual": 2652052.12
+        },
+        {
+          "month": 33,
+          "plan": 3544650.27,
+          "optimistic": 3912824.32,
+          "pessimistic": 3236729.64,
+          "actual": 2819959.32
+        },
+        {
+          "month": 36,
+          "plan": 3773042.08,
+          "optimistic": 4210451.13,
+          "pessimistic": 3412626.23,
+          "actual": 2986771.46
+        },
+        {
+          "month": 39,
+          "plan": 3999999.87,
+          "optimistic": 4513659.35,
+          "pessimistic": 3582970.23,
+          "actual": 3152638.68
+        }
+      ]
+    }
   },
   "sensitivity": {
     "base_contrib_uah": 62987.08,

internal/api/web/js/charts.js

@@ -76,6 +76,49 @@ export function svgLine(xlabels, series) {
   return `<svg viewBox="0 0 ${W} ${H}" style="width:100%;height:auto">${lines}${xl}</svg>`;
 }
 
+/** Крива прогнозу: коридор між двома серіями, лінії всередині нього і
+ *  горизонтальна лінія цілі.
+ *
+ *  Окремо від svgLine навмисно. Той малює рівноправні серії по спільних
+ *  мітках; тут же в серій РІЗНІ ролі — дві задають межі коридору, третя
+ *  йде посередині, четверта показує відхилення від неї, а ціль це взагалі
+ *  не серія, а орієнтир. Запхати ролі в svgLine означало б додати йому
+ *  чотири прапорці й зламати два наявні виклики.
+ *
+ *  bands: {lo, hi} — значення нижньої й верхньої межі коридору (може
+ *  бути порожньо). lines: [{color, values, dash}]. goal — число або 0.
+ *  xlabels — підписи, порожній рядок = мітки немає. */
+export function svgBandLine(xlabels, bands, lines, goal) {
+  const W = 320, H = 170, Pl = 8, Pr = 8, Pt = 14, Pb = 28;
+  const iw = W - Pl - Pr, ih = H - Pt - Pb;
+  const n = Math.max(1, xlabels.length);
+  // Ціль входить у масштаб: інакше лінія цілі вилітала б за полотно, і
+  // «не дотягуємо» виглядало б як «дотягуємо».
+  const all = lines.flatMap((s) => s.values).concat(bands.hi || [], [goal || 0]);
+  const max = Math.max(1, ...all);
+  const X = (i) => Pl + (n <= 1 ? iw / 2 : (iw * i) / (n - 1));
+  const Y = (v) => Pt + ih - (v / max) * ih;
+  let out = "";
+  if ((bands.lo || []).length && (bands.hi || []).length) {
+    const up = bands.hi.map((v, i) => `${X(i).toFixed(1)},${Y(v).toFixed(1)}`);
+    const down = bands.lo.map((v, i) => `${X(i).toFixed(1)},${Y(v).toFixed(1)}`).reverse();
+    out += `<polygon points="${up.concat(down).join(" ")}" fill="var(--oi-series-invested)" opacity="0.12"/>`;
+  }
+  if (goal > 0) {
+    const y = Y(goal).toFixed(1);
+    out += `<line x1="${Pl}" y1="${y}" x2="${W - Pr}" y2="${y}" stroke="${AXIS}"`
+      + ` stroke-width="1" stroke-dasharray="4 3"/>`;
+  }
+  out += lines.map((s) =>
+    `<polyline points="${s.values.map((v, i) => `${X(i).toFixed(1)},${Y(v).toFixed(1)}`).join(" ")}"`
+    + ` fill="none" stroke="${s.color}" stroke-width="2.5" stroke-linejoin="round"`
+    + `${s.dash ? ` stroke-dasharray="${s.dash}"` : ""}/>`).join("");
+  out += xlabels.map((l, i) => l
+    ? `<text x="${X(i).toFixed(1)}" y="${H - 10}" text-anchor="middle" font-size="10" fill="${AXIS}">${esc(l)}</text>`
+    : "").join("");
+  return `<svg viewBox="0 0 ${W} ${H}" style="width:100%;height:auto">${out}</svg>`;
+}
+
 /** Кільце часток. parts: [{label, value}] — уже відсортовані.
  *  Повертає {svg, colors}: легенду малює той, хто кличе, бо підпис
  *  частки в різних місцях різний (сума, відсоток, і те й те). */