deploy.

2026-09-12 18:16:27 +08:00
parent b7f55aa631
commit 397a7a8cc4
96 changed files with 1167 additions and 1259 deletions
@@ -237,9 +237,9 @@ but with one panel mounted at a time, the change that matters in practice is a p
 <h2 id="the-table-primitive">The Table Primitive</h2>
 <p>Where a leaf renders a table it is Quasar's markup table — dense, flat, bordered — with a
 hand-written header and body and a repeat over the rows. No panel in the branch uses the data-table
-component, and the four data tables left in the application are the legacy controller tabs this
-branch supersedes. The practical difference is that these tables have no built-in sort, no pagination
-and no column menu: what the header says is what the column is.</p>
+component, and since the legacy controller tabs were removed nothing else in the application does
+either. The practical difference is that these tables have no built-in sort, no pagination and no
+column menu: what the header says is what the column is.</p>
 <p>Key columns are rendered as plain text and cannot be edited: the tool and edge numbers of a <code>$TC_DP</code>
 row, a tool name, an <code>R</code> number, a <code>#</code> variable number, a datum row index, a native parameter id, and
 the axis names of every per-axis table, which follow the machining chain rather than the panel. The
@@ -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>
@@ -308,9 +308,6 @@ row as seeded. The legacy work-coordinate table is replayed first, through the s
 aliases onto preset rows 1 through 6, so where the two overlap the explicit datum copy is what
 stands.</li>
 </ul>
-<p>The superseded <code>/controller</code> route also carries datum preset and datum shift surfaces, over the
-separate environment model rather than over the runner — an edit made there does not reach the table
-on this page. That route's own 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>
@@ -110,8 +110,9 @@ application.</p>
 <li><a href="controller/index.html">Controller</a> — The SoftNcRunner-native controller branch: its two planes, the brand matrix behind which nodes appear at all, and the contract every leaf edits by</li>
 <li><a href="hidden-controllers.html">Hidden Controller Branches</a> — The two runner-suit nodes a fresh installation never builds, the device-local checkboxes that reveal them, and the second kind of invisibility a link cannot undo</li>
 </ul>
-<p>The superseded <a class="xref" href="../legacy-controller.html">Legacy Controller</a> screen at its own route is a separate
-surface, editing a different model from the branch above.</p>
+<p>A bookmark to the retired <code>/controller</code> address — the Legacy Controller page, which edited the
+deprecating HardNcEnv model rather than the runner — now redirects here and lands on the Controller
+branch.</p>
 <h2 id="see-also">See Also</h2>
 <ul>
 <li><a class="xref" href="../execution/index.html">Execution Page</a> — the other Control-Tree page, and the one this was split out of</li>
@@ -120,8 +121,7 @@ surface, editing a different model from the branch above.</p>
 <li><a class="xref" href="../platform/control-tree.html">Control Tree</a> — the engine behind this page's tree: how a branch is built, rebuilt and selected</li>
 <li><a href="controller/index.html">Controller Branch</a> — the branch this page hosts whose node set changes with the controller brand</li>
 <li><a href="hidden-controllers.html">Hidden Controller Branches</a> — the two equipment nodes this page withholds until a preference or a link asks for them</li>
-<li><a class="xref" href="../legacy-controller.html">Legacy Controller</a> — the superseded controller screen at its own route: its seven tabs, how an edit commits, and its viewer</li>
-<li><a class="xref" href="../legacy-controller-settings.html">Legacy Controller Settings</a> — the model that screen edits, and the three settings the equipment tree has no editor for</li>
+<li><a class="xref" href="../legacy-controller-settings.html">Legacy Controller Model (HardNcEnv)</a> — the deprecating HardNcEnv model the project still carries beside the runner, what it shares with the Controller branch, and the three settings that retire with it rather than gaining an editor in the equipment tree</li>
 </ul>

 </article>