proof(guide, blocks.value))
+const errorCount = computed(() => issues.value.filter(i => i.level === 'error').length)
+
+function jumpTo (blockid) {
+ focused.value = blockid
+ const node = textareas[blockid] || itemInputs[blockid]
+ if (node?.scrollIntoView) {
+ node.scrollIntoView({ behavior: 'smooth', block: 'center' })
+ node.focus?.()
+ }
+}
+
+function fix (item) {
+ const block = blocks.value.find(b => b.id === item.blockid)
+ if (block && applyFix(block, item.fix)) dirty.value = true
+}
const isNew = computed(() => !guide.guideid)
const canpublish = computed(() => auth.hasPermission?.('guides.publish') ?? false)
@@ -425,6 +470,12 @@ onBeforeRouteLeave(() => {
})
async function publish () {
+ if (errorCount.value) {
+ const ok = window.confirm(
+ errorCount.value + ' problem(s) would go out with this guide, including '
+ + 'anything flagged in a command. Publish anyway?')
+ if (!ok) return
+ }
await save(true)
try {
const response = await api.post('/guides/' + guide.guideid + '/publish')
@@ -608,6 +659,26 @@ onMounted(async () => {
.ge-previewtitle { margin: 0 0 0.2rem; font-size: 1.4rem; }
.ge-previewsummary { color: var(--text-light); margin: 0 0 1rem; }
+.ge-proof {
+ border: 1px solid var(--border); border-left: 3px solid var(--warning, #d9822b);
+ border-radius: 4px; padding: 0.5rem 0.7rem; margin-bottom: 1rem;
+ font-size: 0.82rem;
+}
+.ge-proofhead { display: flex; align-items: center; gap: 0.5rem; }
+.ge-proofhead button {
+ margin-left: auto; font-size: 0.72rem; background: none; border: none;
+ color: var(--text-light); cursor: pointer; text-decoration: underline;
+}
+.ge-proof ul { margin: 0.4rem 0 0; padding: 0; list-style: none; }
+.ge-proof li { display: flex; gap: 0.4rem; align-items: baseline; padding: 0.15rem 0; }
+.ge-error span { color: var(--danger, #c0392b); }
+.ge-warn span { color: var(--text-light); }
+.ge-jump, .ge-fix {
+ font-size: 0.68rem; padding: 0.05rem 0.35rem; border: 1px solid var(--border);
+ background: transparent; color: var(--text-light); border-radius: 3px; cursor: pointer;
+}
+.ge-fix { margin-left: auto; border-color: var(--primary); color: var(--primary); }
+
.ge-revisions { margin-top: 2rem; border-top: 1px solid var(--border); padding-top: 0.8rem; }
.ge-rev { display: flex; gap: 0.6rem; align-items: center; font-size: 0.8rem; padding: 0.25rem 0; }
.ge-revnum { font-weight: 600; }
diff --git a/shopdb/core/api/search.py b/shopdb/core/api/search.py
index d023304c..70da6bc1 100644
--- a/shopdb/core/api/search.py
+++ b/shopdb/core/api/search.py
@@ -255,6 +255,55 @@ def _search_applications(query, search_term):
return results
+def _search_guides(query, search_term):
+ """Search guides by title, summary, tags and BODY.
+
+ The body matters more here than in most domains. People look for a procedure
+ by something written halfway down it - "the one about the drive letter" -
+ not by a title they never read. The body is a JSON blob of blocks, so this
+ is a LIKE against it: crude, but it finds the guide, and a guide corpus is
+ tens of documents rather than millions of rows.
+
+ PUBLISHED ONLY. A draft is deliberately invisible to readers, and search is
+ the one place that rule would otherwise leak - somebody would find a
+ half-written procedure through the search box and follow it.
+ """
+ results = []
+ try:
+ _require_enabled('guides')
+ from plugins.guides.models import Guide
+
+ rows = Guide.query.filter(
+ Guide.isactive == True,
+ Guide.publishedrevisionid.isnot(None),
+ _word_match(query, Guide.title, Guide.summary, Guide.tags,
+ Guide.blocksjson)
+ ).order_by(Guide.modifieddate.desc()).limit(20).all()
+
+ for guide in rows:
+ # A title match outranks a body match: someone searching "marker"
+ # wants the guide called that, not every guide mentioning one.
+ relevance = 10
+ if query.lower() in (guide.title or '').lower():
+ relevance += 20
+ if guide.tags and query.lower() in guide.tags.lower():
+ relevance += 15
+
+ results.append({
+ 'type': 'guide',
+ 'id': guide.guideid,
+ 'title': guide.title,
+ 'subtitle': guide.summary,
+ 'url': f"/guides/{guide.slug}",
+ 'relevance': relevance
+ })
+ except ImportError:
+ pass # guides plugin absent or disabled
+ except Exception as e:
+ logger.error(f"Guides search failed: {e}")
+ return results
+
+
def _search_knowledgebase(query, search_term):
"""Search Knowledge Base by description and keywords.
@@ -1148,6 +1197,7 @@ def global_search():
# Run all search domains
results.extend(_search_applications(query, search_term))
results.extend(_search_knowledgebase(query, search_term))
+ results.extend(_search_guides(query, search_term))
results.extend(_search_employees(query, search_term))
results.extend(_search_assets(query, search_term))
results.extend(_search_measuringtools(query, search_term))
diff --git a/tests/test_core/test_search_coverage.py b/tests/test_core/test_search_coverage.py
index 57c53115..d80fd3cb 100644
--- a/tests/test_core/test_search_coverage.py
+++ b/tests/test_core/test_search_coverage.py
@@ -266,3 +266,75 @@ def test_an_ip_search_links_to_the_matched_subnet(client, subnetrow):
assert len(rows) == 1
assert rows[0]['id'] == subnetrow
assert rows[0]['url'] == f'/networks/{subnetrow}'
+
+
+# ---------------------------------------------------------------------------
+# Guides. A guide is not an asset either, so the generic asset search cannot see
+# one - and the draft rule makes the omission worse than invisibility: a
+# half-written procedure reachable through the search box is one somebody
+# follows.
+# ---------------------------------------------------------------------------
+
+@pytest.fixture
+def guides(db):
+ """One published guide and one draft, with distinctive text.
+
+ The published one carries its distinguishing words in the BODY, not the
+ title, because that is how people look for a procedure - by something
+ written halfway down it.
+ """
+ from plugins.guides.models import Guide
+ from plugins.guides.services import authoring
+
+ published = Guide(title='Zzmarker controller swap', slug='zzmarker-swap',
+ status='draft')
+ draft = Guide(title='Zzdraft unfinished procedure', slug='zzdraft-unfinished',
+ status='draft')
+ db.session.add_all([published, draft])
+ db.session.flush()
+
+ authoring.save(published, title=published.title,
+ summary='Restoring after a swap', tags='zztelesis, zzbackups',
+ blocks=[{'id': 'g1', 'type': 'paragraph',
+ 'text': 'Check the zzmappeddrive before starting.'}])
+ authoring.publish(published)
+ authoring.save(draft, title=draft.title, summary='', tags='zztelesis',
+ blocks=[{'id': 'g2', 'type': 'paragraph',
+ 'text': 'Half written zzmappeddrive notes.'}])
+ db.session.commit()
+ return {'published': published.guideid, 'draft': draft.guideid}
+
+
+def test_a_published_guide_is_found_by_title(client, guides):
+ rows = [r for r in search(client, 'Zzmarker') if r['type'] == 'guide']
+ assert len(rows) == 1
+ assert rows[0]['id'] == guides['published']
+ assert rows[0]['url'] == '/guides/zzmarker-swap'
+
+
+def test_a_guide_is_found_by_tag(client, guides):
+ """Tags are how a technician narrows to a family of procedures."""
+ assert 'Zzmarker controller swap' in titles(client, 'zzbackups', 'guide')
+
+
+def test_a_guide_is_found_by_words_in_its_body(client, guides):
+ """People search for what they remember reading, not for the title.
+
+ The body is stored as a JSON blob of blocks, so this is the check that the
+ blob is actually reachable rather than merely present.
+ """
+ assert 'Zzmarker controller swap' in titles(client, 'zzmappeddrive', 'guide')
+
+
+def test_a_draft_guide_is_never_returned(client, guides):
+ """The draft rule has to hold on EVERY path that reaches the row.
+
+ A draft is deliberately invisible to readers, and search is where that rule
+ would otherwise leak: somebody finds a half-written procedure through the
+ search box and follows it. The draft here shares a tag and a body word with
+ the published guide, so it would ride along on both queries if the filter
+ were missing.
+ """
+ assert 'Zzdraft unfinished procedure' not in titles(client, 'zzmappeddrive', 'guide')
+ assert 'Zzdraft unfinished procedure' not in titles(client, 'zztelesis', 'guide')
+ assert titles(client, 'Zzdraft', 'guide') == []