Buildings and levels for the floor map, and make every identifier searchable

The map was one picture of one floor. A second floor was added, the blueprint
changed size, and machines moved, so a position now records WHICH DRAWING its
coordinates belong to.

Buildings and levels (ADR-017). Each level owns its blueprint per theme and its
own native pixel size; assets.mapx/mapy are pixels of assets.levelid, not of the
site. A position whose level is unknown renders "level unknown" and is never
drawn on the default level, because a marker on the wrong floor plan looks
entirely correct while pointing at the wrong place.

Repositioning in bulk: filter by unplaced, needs-review or level, search, place,
confirm. Landmark recalibration solves the transform PER AXIS from landmark
pairs and never from image dimensions - the canvas grew taller without
rescaling, so a dimension-derived scale would stretch Y by 1.57 and be wrong
everywhere. It defaults to a dry run, reports what would land off the drawing,
snapshots before applying, and clears mapverifiedat because a transform is a
guess awaiting review. Snapshots restore, including the level and the review
state, and a restore snapshots first so an undo is undoable.

Search: gaugelabreference was matched only for measuring tools and
maintenancereference was matched nowhere at all, for any asset type, while
Settings happily offers both identifiers on machines and PCs. A tag an operator
is told to record has to be findable or it is a write-only field. USB devices
and printed items were unreachable from search entirely - neither is an asset,
so the generic asset search could not see them and no searcher existed; they
now match on serial, asset tag, label, bin code and gage-lab tag, honouring
isactive, with Settings toggles and result labels to match.

The retired-application rule was half a rule: GET /api/knowledgebase hid
articles whose topic application is retired while global search still returned
them and printed the retired application as the subject. A filter is only real
if every path that reaches the row applies it.

Contract to 0.20.0 (additive): Asset gained levelid and mapverifiedat, Location
gained levelid, and resolve_asset_position returns the levelid belonging to
whichever source supplied the coordinates. The five plugins that write a map
position are re-pinned. The install-list text format gained levelid as a NINTH
field, appended, because the shipped Pascal installer reads fields 0-7 by index.

That installer still compiles in one drawing's dimensions and bundles one
blueprint, so its map is accurate for the default level only; /api/maplevels is
deliberately unauthenticated so it can read both at runtime once rebuilt.
Recorded in PRINTER-INSTALLER.md section 6 along with the other known gaps.

Migration 7d33 converts an existing single-map site into one building and one
default level carrying the old map_* settings, then assigns every placed asset
and location to it. Nothing moves on screen. Old settings rows are kept so a
rollback still finds them. Verified end to end on MySQL 5.6 from a
production-shaped database.

plugins/knowledgebase/api/routes.py

@@ -21,13 +21,35 @@ from shopdb.api import require_permission, apply_import_timestamps
 knowledgebase_bp = Blueprint('knowledgebase', __name__)
 
 
+def _visible_articles():
+    """Active articles whose topic is not a retired application.
+
+    An article about a decommissioned application is not something anyone should
+    find by browsing or searching: it describes a thing that is no longer in
+    service, and presenting it alongside live documentation reads as though it
+    were current.
+
+    An article with NO topic still shows. Not every article is about an
+    application, and a null topic is not a retired one.
+
+    Expressed as a subquery rather than a join because the topic sort below joins
+    Application itself, and two joins onto the same table in one query collide.
+    """
+    retired = db.session.query(Application.appid).filter(
+        Application.isactive.is_(False))
+    return KnowledgeBase.query.filter(
+        KnowledgeBase.isactive.is_(True),
+        db.or_(KnowledgeBase.appid.is_(None),
+               KnowledgeBase.appid.notin_(retired)))
+
+
 @knowledgebase_bp.route('', methods=['GET'])
 @jwt_required(optional=True)
 def list_articles():
     """List all knowledge base articles."""
     page, per_page = get_pagination_params(request)
 
-    query = KnowledgeBase.query.filter_by(isactive=True)
+    query = _visible_articles()
 
     # Search: title, keywords, and the topic (its Application's name). The topic
     # is matched via an appid subquery instead of a join so it does not collide
@@ -35,8 +57,13 @@ def list_articles():
     # clause and still match on title/keywords.
     if search := request.args.get('search'):
         like = f'%{search}%'
+        # Active applications only. A retired application is not a topic anyone
+        # should be offered: matching its name surfaced its articles and printed
+        # the retired app as their subject, which reads as though it were still
+        # in service.
         topic_appids = db.session.query(Application.appid).filter(
-            Application.appname.ilike(like))
+            Application.appname.ilike(like),
+            Application.isactive.is_(True))
         query = query.filter(
             db.or_(
                 KnowledgeBase.shortdescription.ilike(like),
@@ -100,11 +127,11 @@ def list_articles():
 @jwt_required(optional=True)
 def get_stats():
     """Get knowledge base statistics."""
-    total_clicks = db.session.query(
-        db.func.coalesce(db.func.sum(KnowledgeBase.clicks), 0)
-    ).filter(KnowledgeBase.isactive == True).scalar()
-
-    total_articles = KnowledgeBase.query.filter_by(isactive=True).count()
+    # Counted over the same set the list shows. A total that includes articles
+    # nobody can see is a total nobody can reconcile.
+    visible = _visible_articles()
+    total_clicks = sum(article.clicks or 0 for article in visible)
+    total_articles = visible.count()
 
     return success_response({
         'totalclicks': int(total_clicks),

plugins/knowledgebase/frontend/views/KnowledgeBaseForm.vue

@@ -106,7 +106,9 @@ const applications = ref([])
 onMounted(async () => {
   try {
     // Load applications for topic dropdown
-    const appsRes = await applicationsApi.list({ perpage: 1000 })
+    const appsRes = await applicationsApi.list({ perpage: 1000, showhidden: true })  // isactive is the only filter that applies to a topic:
+    // ishidden governs whether an application shows on the tiles page, which
+    // says nothing about whether it can be the subject of an article.
     applications.value = appsRes.data.data || []
 
     // Load article if editing

plugins/knowledgebase/frontend/views/KnowledgeBaseList.vue

@@ -171,7 +171,9 @@ async function loadArticles() {
 
 async function loadTopics() {
   try {
-    const response = await applicationsApi.list({ perpage: 1000 })
+    const response = await applicationsApi.list({ perpage: 1000, showhidden: true })  // isactive is the only filter that applies to a topic:
+    // ishidden governs whether an application shows on the tiles page, which
+    // says nothing about whether it can be the subject of an article.
     topics.value = response.data.data || []
   } catch (error) {
     console.error('Error loading topics:', error)