This commit is contained in:
2026-09-12 18:16:27 +08:00
parent b7f55aa631
commit 397a7a8cc4
96 changed files with 1167 additions and 1259 deletions
@@ -90,8 +90,9 @@
<p>The Controller branch is the SoftNcRunner-native settings face: the controller the project actually
parses NC with, edited one tree node at a time. It lives on the General Setup page at
<code>/general-setup</code> under the Control-Tree id <code>equipment/controller</code>, and grows two plane stems beneath
it — <code>equipment/controller/machine</code> and <code>equipment/controller/program-data</code>. The superseded
HardNcEnv surface still ships as a route of its own at <code>/controller</code>, and edits a different model.</p>
it — <code>equipment/controller/machine</code> and <code>equipment/controller/program-data</code>. A bookmark to the
retired <code>/controller</code> address, where the Legacy Controller page used to edit the deprecating HardNcEnv
model instead of the runner, redirects to this branch root.</p>
<div class="IMPORTANT">
<h5>Important</h5>
<p>Anatomy makes no claim that these ids are stable across versions. See
@@ -230,12 +231,6 @@ switch. No panel refreshes it, so an edit that empties a table changes neither t
branch until one of those happens.</p>
<p>Both structural writes are refused while an NC program is playing: installing a runner and switching
brand each answer a conflict rather than swapping the parser under a running session.</p>
<h2 id="the-superseded-route">The Superseded Route</h2>
<p>The legacy controller page still ships at <code>/controller/:tab?</code> and is reached from the app menu bar's
<strong>Page → Legacy-Controller</strong> entry. It edits <a class="xref" href="../../../api/Hi.Numerical.HardNcEnv.html">HardNcEnv</a> through its own REST
surface, which is a different model from the runner this branch edits — the two are not two views of
one object, and an edit on one is invisible to the other. Its anatomy is
<a class="xref" href="../../legacy-controller.html">Legacy Controller Page</a>.</p>
<h2 id="layout">Layout</h2>
<ul>
<li><strong>General Setup</strong> Control Tree — the left dock of <code>/general-setup</code>
@@ -319,9 +314,8 @@ browser and its extension filter, the expected type it sends with a paste, and t
panel listens to.</li>
<li><code>wwwroot-src/src/pages/GeneralSetupPage.vue</code> — the route that creates the <code>equipment</code>-scoped tree
host this branch is built in.</li>
<li><code>wwwroot-src/src/router/routes.ts</code> — the <code>/general-setup</code> route and the still-shipping
<code>/controller/:tab?</code> route beside it.</li>
<li><code>wwwroot-src/src/components/AppMenuBar.vue</code> — the Page menu entry that reaches the legacy route.</li>
<li><code>wwwroot-src/src/router/routes.ts</code> — the <code>/general-setup</code> route, and the redirect stub that sends a
bookmarked <code>/controller</code> address to this branch root.</li>
<li><code>wwwroot-src/src/i18n/en/softNc.ts</code> — every label, group intro, hint and empty string this branch
renders.</li>
<li><code>wwwroot-src/src/i18n/en/tree.ts</code> — the <strong>Controller</strong> root label.</li>
@@ -378,10 +372,8 @@ settings, one page per editor</li>
ownership rules that keep them on the project</li>
<li><a class="xref" href="../index.html">General Setup Page</a> — the page that hosts this branch, and the equipment items beside it</li>
<li><a class="xref" href="../../platform/control-tree.html">Control Tree</a> — the engine that builds, rebuilds and selects this branch</li>
<li><a class="xref" href="../../legacy-controller.html">Legacy Controller Page</a> — the superseded HardNcEnv route this branch replaces, still shipped
at <code>/controller</code></li>
<li><a class="xref" href="../../legacy-controller-settings.html">Legacy Controller Settings</a> — the model that route edits, what this branch shares with
it, and the three settings it holds alone</li>
<li><a class="xref" href="../../legacy-controller-settings.html">Legacy Controller Model (HardNcEnv)</a> — the deprecating HardNcEnv model the project still carries
beside this runner, what this branch shares with it, and the three settings that retire with it</li>
</ul>
</article>