docs: document KAV, Lone Pine, Lazy B and Sweet Grass configure context
This commit is contained in:
+17
-7
@@ -2,7 +2,17 @@
|
||||
|
||||
Inspected through the signed-in browser on October 20, 2026. Purpose: prepare to build another Atom HMI installation using existing page patterns and copy/paste. No pages, registers, alarms, device connections, or element definitions were saved or changed. The element Copy control was exercised once; no paste was performed.
|
||||
|
||||
## Coverage
|
||||
## October 21, 2026 follow-up
|
||||
|
||||
Read the site-specific guides before future work: [KAV](KAV-GUIDE.md), [Lone Pine](LONE-PINE-GUIDE.md), [Lazy B](LAZY-B-GUIDE.md), [Sweet Grass](SWEET-GRASS-GUIDE.md). They record production URLs, page slugs, roots, representative register bindings, units/conversions and unresolved issues. Start with the relevant guide and current target subtree; the general discovery survey does not need to be repeated.
|
||||
|
||||
Catalogs now cover 202 pages: KAV Main Mill 43, East Mill 4, Main Water 29, East Water 38, Sweet Grass 51, Lone Pine 16, Lazy B 21. The table below is the **historical October 20 coverage**, not a claim that every page was revisited October 21. The follow-up opened all Lone Pine/Lazy B/East Mill trees, refreshed selected active KAV/Sweet Grass trees, inspected the newly listed Mill 2 Test, and resolved both Sweet Grass motor-tree gaps.
|
||||
|
||||
Scope was production Configure Pages and native Copy inspection only. No pastes, site saves, register writes, device actions or operational tests. Development equivalence was not checked. User's two work environments are dev.atomhmi.com and atomhmi.com (observed production host www.atomhmi.com).
|
||||
|
||||
Notable unresolved findings: Well 10 New chlorine display reads g_well10ChemPPM but writes g_well1ChemPPM; Lazy B Well 3 timer fields reference wellNW1; East Water Wells has two Well 29 series, one bound to Well 30. These are documented, unchanged configurations, not verified corrections.
|
||||
|
||||
## Original October 20 coverage
|
||||
|
||||
| Site | Pages listed | Page trees inspected | Main use |
|
||||
| --- | ---: | ---: | --- |
|
||||
@@ -13,9 +23,9 @@ Inspected through the signed-in browser on October 20, 2026. Purpose: prepare to
|
||||
| KAV East - Water (`site_kav_east_water`) | 38 | 38 | Multiple cisterns, transfers, distribution circuits, wells, temperature |
|
||||
| Total | 164 | 162 | |
|
||||
|
||||
Coverage means opening each page in Configure Pages and inspecting its rendered preview and element names/types. It does not mean every element's settings were opened or every runtime control tested. Sweetgrass `Motors` and `old Motors` timed out in their large editors and remain incomplete. Representative configuration dialogs were inspected for rows, status indicators, gauges, trends, numeric data, command buttons, viewports, and images. All dialogs were closed without saving. No source-code or backend API access was established.
|
||||
Coverage means opening each page in Configure Pages and inspecting its rendered preview and element names/types. It does not mean every element's settings were opened or every runtime control tested. Sweetgrass `Motors` and `old Motors` timed out in the original study; both trees and native root Copy were successfully inspected on October 21 (see SWEET-GRASS-GUIDE.md). Representative configuration dialogs were inspected for rows, status indicators, gauges, trends, numeric data, command buttons, viewports, and images. All dialogs were closed without saving. No source-code or backend API access was established.
|
||||
|
||||
The rendered Sweetgrass Motors page was successfully inspected separately after the builder timeout. It repeats motor-ID/name cards with Auto/Manual, Start/Stop, time since start, and optional frequency adjustment; the South Elevator Valve has Rev/Stop/Fwd and raw position. Its element tree and exact write bindings remain unverified.
|
||||
The rendered Sweetgrass Motors page was successfully inspected separately after the builder timeout. It repeats motor-ID/name cards with Auto/Manual, Start/Stop, time since start, and optional frequency adjustment; the South Elevator Valve has Rev/Stop/Fwd and raw position. Its element tree and representative write bindings were subsequently verified on October 21; see SWEET-GRASS-GUIDE.md. Physical command behavior remains untested.
|
||||
|
||||
The complete page-name inventory is in `PAGE-INVENTORY.md`.
|
||||
|
||||
@@ -36,7 +46,7 @@ The builder requires cancelling or saving the currently selected page before sel
|
||||
|
||||
Pages are nested trees. Rows and Divs contain labels, indicators, readouts, buttons, gauges, links, charts, or other containers. The Overview page is a good small example: a Main Selection row contains equipment cards, and each card includes a title, separator, status indicator, and page link with a settings icon.
|
||||
|
||||
The UI exposes element copy, paste, reorder, add, edit, and delete controls; there are also page-level Add Element and Paste Element controls. The copy icon was confirmed as `fa-copy`, and paste as `fa-paste`. Copying the top row of KAV East Water Wells left the browser text clipboard empty. **Inference:** the builder uses an application-managed clipboard or another mechanism. Its serialization, child-copy behavior, persistence across navigation, and cross-site compatibility have not been verified. Do not promise external JSON paste until a disposable-page test confirms it.
|
||||
The UI exposes element copy, paste, reorder, add, edit, and delete controls, including page-level Add Element and Paste Element. **Correction, October 21:** native Copy exports plain-text JSON with id, name, type, data and nested elements. Successful copies across KAV, Lone Pine, Lazy B and Sweet Grass supersede the earlier inference from an empty clipboard. Verify the copied root id/name before using it. A root copy includes that subtree, not the page's other roots. This survey used Copy only; see ATOMHMI-PLAYBOOK.md for earlier authorized development paste tests.
|
||||
|
||||
Styling uses Classes and Styles. Observed classes include `col-6`, `col-12`, `w-100`, `h-100`, `border`, `rounded`, `badge`, `badge-pill`, `bg-danger`, `bg-warning`, `bg-on`, `bg-off`, `btn-start`, and `btn-entry`. These resemble Bootstrap conventions plus application-specific classes. Reuse the parent container's spacing and widths instead of reconstructing each child independently.
|
||||
|
||||
@@ -126,11 +136,11 @@ Manage Elements lists 46 component definitions, with five marked “Dont Use.”
|
||||
|
||||
## Remaining evidence needed
|
||||
|
||||
- Sweetgrass Motors and old Motors trees, which timed out.
|
||||
- Actual application clipboard format, nested copy semantics, and cross-site paste behavior.
|
||||
- Resolved October 21: Sweetgrass Motors (1,435 elements) and old Motors (1,246) trees and native root Copy. See SWEET-GRASS-GUIDE.md.
|
||||
- Clipboard JSON format and subtree copying are verified; cross-site paste behavior still requires destination-specific validation. This production survey did not paste.
|
||||
- A controlled new-page save/reopen test and navigation/default-page test.
|
||||
- Intended new installation's equipment, controller tags, units, ranges, and command mapping.
|
||||
- Required alarm/notification rules, user roles, history retention, and exports.
|
||||
- Whether a supported Atom HMI API or import/export interface can replace browser editing for a standalone agent. No such interface was verified in this study.
|
||||
|
||||
This survey establishes a browser editing approach and a template map. It does not yet establish a fully tested autonomous editing agent.
|
||||
This survey establishes a browser editing approach and a template map. It does not yet establish a fully tested autonomous editing agent.
|
||||
Reference in New Issue
Block a user