RnD/EVOLV
3
0
Fork 0
Code Issues 22 Pull Requests Actions 1 Packages Projects Releases Wiki Activity

wiki: crisp overhaul — no decoration emoji, all 9 master pages refactored

Browse Source 
Source-tree mirror of EVOLV.wiki.git refactor (27a42ee on wiki.git):

- 7 master pages rewritten with clean design (Home, Architecture,
  Topology-Patterns, Topic-Conventions, Telemetry, Getting-Started,
  Glossary). Tables and Mermaid for visuals, gitea alert callouts for
  warnings, shields badges for metadata only. No emoji as decoration.
- Archive.md becomes a removal-changelog pointing readers to git
  history and to the successor pages.
- _Sidebar.md updated to navigate the new flat-name layout.
- Concept / finding / manual pages: uniform mini-header (badges +
  "reference page" callout) added without rewriting domain content.
- Every internal link now uses the flat naming that resolves on the
  live gitea wiki (Concept-ASM-Models, Finding-BEP-..., etc.).

On wiki.git: 29 Archive-* pages hard-deleted (the git history
preserves them; Archive.md documents the removal).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
znetsixe
2026-05-11 22:24:51 +02:00
parent 2ccc8aea9e
commit 5ae8788fd7
33 changed files with 1491 additions and 729 deletions
Download Patch File Download Diff File Expand all files Collapse all files

86
wiki/Archive.md
View File

@@ -1,28 +1,64 @@
# Archive — pre-refactor wiki pages
# Archive
Pages kept for historical reference. **Do not update them.** Corrections go on the current page; if you find a meaningful inaccuracy in the archived page, leave it and add a note to the *current* page explaining what changed.
> [!NOTE]
> Pre-refactor wiki content has been removed from the live wiki. The git history of `EVOLV.wiki.git` preserves every prior page if you need to consult it. This page lists what was removed and when, plus where to look for the current content.
| Page | Era | Archived on |
|---|---|---|
| [Wiki schema (SCHEMA.md)](Archive/SCHEMA.md) | Pre-refactor wiki maintenance schema (Obsidian-style) | 2026-05-11 |
| [Wiki index (index.md)](Archive/index.md) | Pre-refactor wiki index (2026-04-13) | 2026-05-11 |
| [Wiki log (log.md)](Archive/log.md) | Pre-refactor session log, single Apr-07 entry | 2026-05-11 |
| [Metrics dashboard (metrics.md)](Archive/metrics.md) | Pre-refactor test counts (Apr-07 snapshot, 43 tests) | 2026-05-11 |
| [Project overview (overview.md)](Archive/overview.md) | Pre-refactor node inventory ("needs review" for most nodes) | 2026-05-11 |
| [Knowledge graph (knowledge-graph.yaml)](Archive/knowledge-graph.yaml) | Apr-07 test / metrics / bug snapshot — superseded by 823 platform tests | 2026-05-11 |
| [Architecture: Node architecture](Archive/architecture-node-architecture.md) | Pre-refactor 3-tier diagram with old `_loadConfig`/`_setupSpecificClass` internals | 2026-05-11 |
| [Architecture: Platform overview](Archive/architecture-platform-overview.md) | Pre-refactor edge/site/central layering vision | 2026-05-11 |
| [Architecture: Stack review](Archive/architecture-stack-review.md) | Pre-refactor full stack analysis (references `temp/*.pdf`, `tagcodering`) | 2026-05-11 |
| [Architecture: 3D pump curves](Archive/architecture-3d-pump-curves.md) | Pre-refactor predict_class / spline internals description | 2026-05-11 |
| [Architecture: Group optimization](Archive/architecture-group-optimization.md) | Pre-refactor BEP-Gravitation algorithm walkthrough | 2026-05-11 |
| [Architecture: Deployment blueprint](Archive/architecture-deployment-blueprint.md) | Pre-refactor Docker topology + rollout order | 2026-05-11 |
| [Concepts: generalFunctions API](Archive/concepts-generalfunctions-api.md) | Pre-refactor API reference — missing BaseDomain / BaseNodeAdapter / ChildRouter | 2026-05-11 |
| [Concepts: Sources readme](Archive/concepts-sources-readme.md) | Empty placeholder for future PDFs (never populated) | 2026-05-11 |
| [Findings: Open issues 2026-03](Archive/findings-open-issues-2026-03.md) | Issues 1–5 all resolved by the refactor (diffuser, monster, dashboardAPI, etc.) | 2026-05-11 |
| [Session: 2026-04-07 production hardening](Archive/sessions-2026-04-07-production-hardening.md) | rotatingMachine + MGC hardening session log | 2026-05-11 |
| [Session: 2026-04-13 rotatingMachine trial-ready](Archive/sessions-2026-04-13-rotatingMachine-trial-ready.md) | FSM interruptibility, config schema sync, UX polish session log | 2026-05-11 |
| [Session: 2026-04-13 measurement digital mode](Archive/sessions-2026-04-13-measurement-digital-mode.md) | Dispatcher bug fix, digital/MQTT mode addition session log | 2026-05-11 |
| [Manual: rotatingMachine (pre-refactor)](Archive/manuals-nodes-rotatingMachine.md) | Per-repo wiki on gitea.wbd-rd.nl/RnD/rotatingMachine is the current page | 2026-05-11 |
| [Manual: measurement (pre-refactor)](Archive/manuals-nodes-measurement.md) | Per-repo wiki on gitea.wbd-rd.nl/RnD/measurement is the current page | 2026-05-11 |
---
Each archived page carries the standard banner at its top (see `.claude/refactor/WIKI_TEMPLATE.md` → Archive banner).
## What was removed (2026-05-11)
The 2026-05-11 wiki refactor removed nine pre-refactor pages from the live `EVOLV.wiki.git`:
| Removed page | Era | Successor |
|:---|:---|:---|
| `Architecture-Configuration-Model-and-Tagcodering` | Pre-refactor planning doc | [Architecture](Architecture) |
| `Architecture-Container-Topology` | Pre-refactor Docker / container planning | [Architecture](Architecture), [Getting Started](Getting-Started) |
| `Architecture-Deployment-Blueprint` | Pre-refactor rollout plan | [Architecture](Architecture), [Getting Started](Getting-Started) |
| `Architecture-Deployment-Controls-Checklist` | Pre-refactor go / no-go checklist | (none &mdash; superseded by per-node `wiki/Home.md`) |
| `Architecture-Platform-Overview` | Pre-refactor edge / site / central layering | [Home](Home), [Architecture](Architecture) |
| `Architecture-Security-and-Access-Boundaries` | Pre-refactor security model | [OT Security IEC 62443](Concept-OT-Security-IEC62443) |
| `Architecture-Security-and-Regulatory-Mapping` | Pre-refactor IEC 62443 mapping | [OT Security IEC 62443](Concept-OT-Security-IEC62443) |
| `Architecture-Telemetry-and-Smart-Storage` | Pre-refactor telemetry blueprint | [Telemetry](Telemetry), [InfluxDB Schema Design](Concept-InfluxDB-Schema-Design) |
| `AI-assisted coding.-` | Pre-refactor coding-with-AI usage note | (none) |
Plus, in the source tree under `EVOLV/wiki/`, the audit moved a further 20 stale pages to `wiki/Archive/<name>.md` (these were never published to the live wiki, only existed in the source repo).
---
## How to recover an archived page
The content has not been lost &mdash; git keeps it.
```bash
git clone https://gitea.wbd-rd.nl/RnD/EVOLV.wiki.git
cd EVOLV.wiki
git log --all --diff-filter=D --name-only | grep '<page-name>'
git show <commit>:<path>
```
Or use Gitea's web UI:
1. Open https://gitea.wbd-rd.nl/RnD/EVOLV/commits/branch/main
2. Click into the 2026-05-11 refactor commit
3. Scroll to the deleted files
---
## Where to look instead
| For ... | See |
|:---|:---|
| Top-level navigation | [Home](Home) |
| Code architecture (BaseDomain / three-tier / generalFunctions) | [Architecture](Architecture) |
| Typical plant configurations | [Topology Patterns](Topology-Patterns) |
| Topic naming, units, S88 colours | [Topic Conventions](Topic-Conventions) |
| Port 0 / 1 / 2, InfluxDB schema, Grafana | [Telemetry](Telemetry) |
| Per-node operator reference | The node's own wiki on `gitea.wbd-rd.nl/RnD/<node>/wiki` |
---
## Related pages
| Page | Why |
|:---|:---|
| [Home](Home) | Current top-level navigation |