rewrite 2026-09 and 2027 articles for reader-facing quality
Build and deploy / deploy (push) Successful in 18s
Build and deploy / deploy (push) Successful in 18s
This commit is contained in:
+38
-6
@@ -1,7 +1,39 @@
|
||||
<svg xmlns="http://www.w3.org/2000/svg" width="720" height="590" viewBox="0 0 720 590" role="img" aria-labelledby="title desc">
|
||||
<title id="title">Матрица обязанностей контракта</title><desc id="desc">Четыре строки различают query, command, read model и problem envelope. Красная нижняя строка запрещает доменный вывод из отправленной команды.</desc>
|
||||
<rect width="720" height="590" fill="#f8fafc"/><text x="34" y="48" font-family="Arial,sans-serif" font-size="28" font-weight="700" fill="#152238">Boundary: право на вывод</text>
|
||||
<rect x="32" y="82" width="656" height="54" fill="#173a78"/><text x="52" y="118" font-family="Arial,sans-serif" font-size="23" font-weight="700" fill="#fff">Форма</text><text x="246" y="118" font-family="Arial,sans-serif" font-size="23" font-weight="700" fill="#fff">Даёт UI</text><text x="500" y="118" font-family="Arial,sans-serif" font-size="23" font-weight="700" fill="#fff">Не даёт UI</text>
|
||||
<g font-family="Arial,sans-serif" font-size="22" fill="#152238"><rect x="32" y="136" width="656" height="76" fill="#e8f0fe"/><text x="52" y="182">query</text><text x="246" y="182">вопрос к model</text><text x="500" y="182">изменение domain</text><rect x="32" y="212" width="656" height="76" fill="#eef7e9"/><text x="52" y="258">command</text><text x="246" y="258">intent</text><text x="500" y="258">успешный факт</text><rect x="32" y="288" width="656" height="76" fill="#fff3df"/><text x="52" y="334">read model</text><text x="246" y="334">status + actions</text><text x="500" y="334">скрытую причину</text><rect x="32" y="364" width="656" height="76" fill="#f2edfb"/><text x="52" y="410">problem</text><text x="246" y="410">code + retry</text><text x="500" y="410">догадку о retry</text></g>
|
||||
<rect x="32" y="472" width="656" height="74" rx="12" fill="#fce8ea" stroke="#b3263a" stroke-width="3"/><text x="52" y="518" font-family="Arial,sans-serif" font-size="23" font-weight="700" fill="#8a1f2d">Отправка command ≠ новый domain fact</text><text x="34" y="574" font-family="Arial,sans-serif" font-size="19" fill="#526273">Матрица для plan review; не описание реального API.</text>
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 720 420" role="img" aria-labelledby="title desc">
|
||||
<title id="title">HTTP результат и следующий шаг UI</title>
|
||||
<desc id="desc">Таблица-схема связывает 2xx, 409 и 422, 429 и 5xx с разрешённым действием интерфейса и показывает, что отправка команды сама по себе не меняет модель экрана.</desc>
|
||||
<rect width="720" height="420" rx="24" fill="#f7f3ea"/>
|
||||
<g font-family="Arial, sans-serif" fill="#202124">
|
||||
<text x="42" y="48" font-size="24" font-weight="700">Статус задаёт ветку, не весь смысл</text>
|
||||
<text x="42" y="75" font-size="16" fill="#5f6368">каждому результату — свой следующий шаг</text>
|
||||
<g font-size="16" font-weight="700">
|
||||
<rect x="42" y="112" width="118" height="48" rx="8" fill="#d7e8ff" stroke="#2b5f9e" stroke-width="2"/>
|
||||
<rect x="178" y="112" width="206" height="48" rx="8" fill="#d7e8ff" stroke="#2b5f9e" stroke-width="2"/>
|
||||
<rect x="402" y="112" width="250" height="48" rx="8" fill="#d7e8ff" stroke="#2b5f9e" stroke-width="2"/>
|
||||
<text x="101" y="143" text-anchor="middle">результат</text>
|
||||
<text x="281" y="143" text-anchor="middle">что известно</text>
|
||||
<text x="527" y="143" text-anchor="middle">следующий шаг UI</text>
|
||||
</g>
|
||||
<g font-size="16">
|
||||
<rect x="42" y="174" width="118" height="42" rx="8" fill="#d9f1e1" stroke="#2e7d51" stroke-width="2"/>
|
||||
<rect x="178" y="174" width="206" height="42" rx="8" fill="#fff" stroke="#b7b7b7"/>
|
||||
<rect x="402" y="174" width="250" height="42" rx="8" fill="#fff" stroke="#b7b7b7"/>
|
||||
<text x="101" y="201" text-anchor="middle" font-weight="700">200 + JSON</text>
|
||||
<text x="192" y="201">valid representation</text>
|
||||
<text x="416" y="201">render from model</text>
|
||||
<rect x="42" y="224" width="118" height="42" rx="8" fill="#fff1cf" stroke="#a87400" stroke-width="2"/>
|
||||
<rect x="178" y="224" width="206" height="42" rx="8" fill="#fff" stroke="#b7b7b7"/>
|
||||
<rect x="402" y="224" width="250" height="42" rx="8" fill="#fff" stroke="#b7b7b7"/>
|
||||
<text x="101" y="251" text-anchor="middle" font-weight="700">409 / 422</text>
|
||||
<text x="192" y="251">domain rejection</text>
|
||||
<text x="416" y="251">show reason or refetch</text>
|
||||
<rect x="42" y="274" width="118" height="42" rx="8" fill="#fff1cf" stroke="#a87400" stroke-width="2"/>
|
||||
<rect x="178" y="274" width="206" height="42" rx="8" fill="#fff" stroke="#b7b7b7"/>
|
||||
<rect x="402" y="274" width="250" height="42" rx="8" fill="#fff" stroke="#b7b7b7"/>
|
||||
<text x="101" y="301" text-anchor="middle" font-weight="700">429 / 5xx</text>
|
||||
<text x="192" y="301">temporary failure</text>
|
||||
<text x="416" y="301">bounded retry policy</text>
|
||||
</g>
|
||||
<rect x="42" y="344" width="610" height="42" rx="10" fill="#ffe2dc" stroke="#b84b3b" stroke-width="2"/>
|
||||
<text x="347" y="371" text-anchor="middle" font-size="17" font-weight="700">command sent ≠ screen state changed: read the next model</text>
|
||||
</g>
|
||||
</svg>
|
||||
|
||||
|
Before Width: | Height: | Size: 2.3 KiB After Width: | Height: | Size: 3.1 KiB |
+38
-8
@@ -1,9 +1,39 @@
|
||||
<svg xmlns="http://www.w3.org/2000/svg" width="720" height="610" viewBox="0 0 720 610" role="img" aria-labelledby="title desc">
|
||||
<title id="title">Цикл evidence для synthetic hand-off</title><desc id="desc">Пять шагов соединяют fixed literal, проверку ownership, stop или counterexample, уточнённый literal и ограниченный synthetic hand-off. Красная ветка возвращает domain claim к read model.</desc>
|
||||
<defs><marker id="b" markerWidth="10" markerHeight="10" refX="8" refY="5" orient="auto"><path d="M0 0L10 5L0 10Z" fill="#1f4b99"/></marker><marker id="r" markerWidth="10" markerHeight="10" refX="8" refY="5" orient="auto"><path d="M0 0L10 5L0 10Z" fill="#b3263a"/></marker></defs>
|
||||
<rect width="720" height="610" fill="#f8fafc"/><text x="34" y="46" font-family="Arial,sans-serif" font-size="28" font-weight="700" fill="#152238">Synthetic evidence loop</text>
|
||||
<g font-family="Arial,sans-serif" font-size="23" text-anchor="middle"><rect x="50" y="115" width="180" height="74" rx="14" fill="#e8f0fe" stroke="#3566b8" stroke-width="3"/><text x="140" y="160" fill="#173a78">fixed literal</text><rect x="270" y="115" width="180" height="74" rx="14" fill="#eef7e9" stroke="#4d8b44" stroke-width="3"/><text x="360" y="160" fill="#245b2e">ownership check</text><rect x="490" y="115" width="180" height="74" rx="14" fill="#fff3df" stroke="#b67617" stroke-width="3"/><text x="580" y="160" fill="#824c00">named result</text><rect x="490" y="335" width="180" height="74" rx="14" fill="#eaf5f7" stroke="#257184" stroke-width="3"/><text x="580" y="380" fill="#1d5c6a">review hand-off</text><rect x="270" y="335" width="180" height="74" rx="14" fill="#f2edfb" stroke="#7051a8" stroke-width="3"/><text x="360" y="380" fill="#553885">new literal</text></g>
|
||||
<path d="M230 152H270M450 152H490M580 189V335M490 372H450M270 372H140V189" fill="none" stroke="#1f4b99" stroke-width="5" marker-end="url(#b)"/>
|
||||
<path d="M580 189V260H190V190" fill="none" stroke="#b3263a" stroke-width="5" marker-end="url(#r)"/><text x="288" y="246" font-family="Arial,sans-serif" font-size="22" font-weight="700" fill="#8a1f2d">domain claim → stop → read question</text>
|
||||
<text x="34" y="510" font-family="Arial,sans-serif" font-size="21" fill="#526273">Positive output: только review hand-off.</text><text x="34" y="546" font-family="Arial,sans-serif" font-size="21" fill="#526273">productionEffect: not-attempted</text><text x="34" y="582" font-family="Arial,sans-serif" font-size="19" fill="#526273">Нет UI trace, сети, файлов или секретов.</text>
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 720 420" role="img" aria-labelledby="title desc">
|
||||
<title id="title">Диагностика рассинхрона UI и API</title>
|
||||
<desc id="desc">Четыре наблюдения сравниваются последовательно: намерение, запрос, ответ и вход в рендер. Несовпадение ведёт к проверке соответствующей границы.</desc>
|
||||
<rect width="720" height="420" rx="24" fill="#f7f3ea"/>
|
||||
<g font-family="Arial, sans-serif" fill="#202124">
|
||||
<text x="42" y="48" font-size="24" font-weight="700">Сравниваем соседние границы</text>
|
||||
<text x="42" y="76" font-size="16" fill="#5f6368">intent → request → response → render input</text>
|
||||
<g font-size="17" font-weight="700">
|
||||
<circle cx="120" cy="184" r="54" fill="#d7e8ff" stroke="#2b5f9e" stroke-width="3"/>
|
||||
<circle cx="290" cy="184" r="54" fill="#d7e8ff" stroke="#2b5f9e" stroke-width="3"/>
|
||||
<circle cx="460" cy="184" r="54" fill="#d9f1e1" stroke="#2e7d51" stroke-width="3"/>
|
||||
<circle cx="630" cy="184" r="54" fill="#d9f1e1" stroke="#2e7d51" stroke-width="3"/>
|
||||
<text x="120" y="178" text-anchor="middle">intent</text>
|
||||
<text x="120" y="201" text-anchor="middle">action</text>
|
||||
<text x="290" y="178" text-anchor="middle">request</text>
|
||||
<text x="290" y="201" text-anchor="middle">HTTP</text>
|
||||
<text x="460" y="178" text-anchor="middle">response</text>
|
||||
<text x="460" y="201" text-anchor="middle">contract</text>
|
||||
<text x="630" y="178" text-anchor="middle">render</text>
|
||||
<text x="630" y="201" text-anchor="middle">input</text>
|
||||
</g>
|
||||
<g stroke="#2b5f9e" stroke-width="3" fill="none">
|
||||
<path d="M174 184h62m170 0h62m170 0h2"/>
|
||||
<path d="m226 177 10 7-10 7m170-7 10 7-10 7m164-7 10 7-10 7"/>
|
||||
</g>
|
||||
<g font-size="16">
|
||||
<rect x="104" y="292" width="152" height="58" rx="12" fill="#fff" stroke="#b7b7b7"/>
|
||||
<rect x="284" y="292" width="152" height="58" rx="12" fill="#fff" stroke="#b7b7b7"/>
|
||||
<rect x="464" y="292" width="152" height="58" rx="12" fill="#ffe2dc" stroke="#b84b3b" stroke-width="2"/>
|
||||
<text x="180" y="317" text-anchor="middle">mapping формы</text>
|
||||
<text x="180" y="338" text-anchor="middle">и безопасный input</text>
|
||||
<text x="360" y="317" text-anchor="middle">route, status,</text>
|
||||
<text x="360" y="338" text-anchor="middle">Content-Type</text>
|
||||
<text x="540" y="317" text-anchor="middle">stale state,</text>
|
||||
<text x="540" y="338" text-anchor="middle">selector или race</text>
|
||||
</g>
|
||||
<text x="42" y="392" font-size="15" fill="#5f6368">Снимок одного слоя не доказывает причину расхождения в другом.</text>
|
||||
</g>
|
||||
</svg>
|
||||
|
||||
|
Before Width: | Height: | Size: 2.6 KiB After Width: | Height: | Size: 2.8 KiB |
+34
-8
@@ -1,9 +1,35 @@
|
||||
<svg xmlns="http://www.w3.org/2000/svg" width="720" height="620" viewBox="0 0 720 620" role="img" aria-labelledby="title desc">
|
||||
<title id="title">Карта владельцев состояния</title><desc id="desc">Три колонки разделяют локальное состояние UI, контекст и API read model. Команда направлена к API, доменный факт не находится в UI.</desc>
|
||||
<defs><marker id="a" markerWidth="10" markerHeight="10" refX="8" refY="5" orient="auto"><path d="M0 0L10 5L0 10Z" fill="#1f4b99"/></marker></defs>
|
||||
<rect width="720" height="620" fill="#f8fafc"/><text x="36" y="48" font-family="Arial,sans-serif" font-size="28" font-weight="700" fill="#152238">Карта владельцев: план на сентябрь</text>
|
||||
<rect x="32" y="90" width="198" height="390" rx="16" fill="#e8f0fe" stroke="#3566b8" stroke-width="3"/><text x="52" y="132" font-family="Arial,sans-serif" font-size="26" font-weight="700" fill="#173a78">UI</text><text x="52" y="182" font-family="Arial,sans-serif" font-size="23" fill="#152238">draft-filter</text><text x="52" y="225" font-family="Arial,sans-serif" font-size="23" fill="#152238">open-panel</text><text x="52" y="388" font-family="Arial,sans-serif" font-size="21" fill="#8a1f2d">не владеет</text><text x="52" y="420" font-family="Arial,sans-serif" font-size="21" fill="#8a1f2d">domain fact</text>
|
||||
<rect x="261" y="90" width="198" height="390" rx="16" fill="#eef7e9" stroke="#4d8b44" stroke-width="3"/><text x="281" y="132" font-family="Arial,sans-serif" font-size="26" font-weight="700" fill="#245b2e">Context</text><text x="281" y="182" font-family="Arial,sans-serif" font-size="23" fill="#152238">fixed-locale</text><text x="281" y="225" font-family="Arial,sans-serif" font-size="23" fill="#152238">permission</text><text x="281" y="388" font-family="Arial,sans-serif" font-size="21" fill="#3d6a35">условие</text><text x="281" y="420" font-family="Arial,sans-serif" font-size="21" fill="#3d6a35">интерпретации</text>
|
||||
<rect x="490" y="90" width="198" height="390" rx="16" fill="#fff3df" stroke="#b67617" stroke-width="3"/><text x="510" y="132" font-family="Arial,sans-serif" font-size="26" font-weight="700" fill="#824c00">API</text><text x="510" y="182" font-family="Arial,sans-serif" font-size="23" fill="#152238">status</text><text x="510" y="225" font-family="Arial,sans-serif" font-size="23" fill="#152238">allowedActions</text><text x="510" y="268" font-family="Arial,sans-serif" font-size="23" fill="#152238">messageCode</text><text x="510" y="388" font-family="Arial,sans-serif" font-size="21" fill="#824c00">read model</text><text x="510" y="420" font-family="Arial,sans-serif" font-size="21" fill="#824c00">и problem</text>
|
||||
<line x1="190" y1="535" x2="530" y2="535" stroke="#1f4b99" stroke-width="5" marker-end="url(#a)"/><text x="270" y="516" font-family="Arial,sans-serif" font-size="22" font-weight="700" fill="#1f4b99">command intent</text><text x="36" y="582" font-family="Arial,sans-serif" font-size="20" fill="#526273">Fixed synthetic model; не trace и не факт системы.</text>
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 720 420" role="img" aria-labelledby="title desc">
|
||||
<title id="title">Проверка ответа перед рендером</title>
|
||||
<desc id="desc">Последовательность из HTTP status, Content-Type, JSON parse, screen model validator и рендера. Ошибка контракта ведёт в отдельную ветку остановки.</desc>
|
||||
<rect width="720" height="420" rx="24" fill="#f7f3ea"/>
|
||||
<g font-family="Arial, sans-serif" fill="#202124">
|
||||
<text x="42" y="48" font-size="24" font-weight="700">До рендера доходят только проверенные данные</text>
|
||||
<text x="42" y="76" font-size="16" fill="#5f6368">transport → format → shape → view</text>
|
||||
<g font-size="17" font-weight="700">
|
||||
<rect x="42" y="132" width="112" height="76" rx="12" fill="#d7e8ff" stroke="#2b5f9e" stroke-width="2"/>
|
||||
<text x="98" y="163" text-anchor="middle">HTTP</text>
|
||||
<text x="98" y="188" text-anchor="middle">status</text>
|
||||
<rect x="178" y="132" width="112" height="76" rx="12" fill="#d7e8ff" stroke="#2b5f9e" stroke-width="2"/>
|
||||
<text x="234" y="163" text-anchor="middle">Content-</text>
|
||||
<text x="234" y="188" text-anchor="middle">Type</text>
|
||||
<rect x="314" y="132" width="112" height="76" rx="12" fill="#d7e8ff" stroke="#2b5f9e" stroke-width="2"/>
|
||||
<text x="370" y="163" text-anchor="middle">JSON</text>
|
||||
<text x="370" y="188" text-anchor="middle">parse</text>
|
||||
<rect x="450" y="132" width="132" height="76" rx="12" fill="#d9f1e1" stroke="#2e7d51" stroke-width="2"/>
|
||||
<text x="516" y="163" text-anchor="middle">screen</text>
|
||||
<text x="516" y="188" text-anchor="middle">validator</text>
|
||||
<rect x="606" y="132" width="72" height="76" rx="12" fill="#d9f1e1" stroke="#2e7d51" stroke-width="2"/>
|
||||
<text x="642" y="174" text-anchor="middle">view</text>
|
||||
</g>
|
||||
<g stroke="#2b5f9e" stroke-width="3" fill="none">
|
||||
<path d="M154 170h20m116 0h20m116 0h20m132 0h24"/>
|
||||
<path d="m168 163 10 7-10 7m136-7 10 7-10 7m136-7 10 7-10 7m136-7 10 7-10 7"/>
|
||||
</g>
|
||||
<rect x="210" y="280" width="300" height="72" rx="14" fill="#ffe2dc" stroke="#b84b3b" stroke-width="2"/>
|
||||
<text x="360" y="309" text-anchor="middle" font-size="19" font-weight="700">ошибка контракта</text>
|
||||
<text x="360" y="333" text-anchor="middle" font-size="16">остановить render и записать код</text>
|
||||
<path d="M516 208v38H360v34" stroke="#b84b3b" stroke-width="3" fill="none"/>
|
||||
<path d="m352 270 8 12 8-12" stroke="#b84b3b" stroke-width="3" fill="none"/>
|
||||
<text x="42" y="391" font-size="15" fill="#5f6368">HTTP 200 сообщает об обмене; validator решает, можно ли использовать representation.</text>
|
||||
</g>
|
||||
</svg>
|
||||
|
||||
|
Before Width: | Height: | Size: 3.1 KiB After Width: | Height: | Size: 2.8 KiB |
Reference in New Issue
Block a user