shopfloor — On-Prem Technical Documentation Assistant

shopfloor — On-Prem Technical Documentation Assistant An architecture diagram generated by Archify. Semantic Cache · cosine + same terms · Plant network — no outbound access, no API keys Semantic Cache cosine + same terms Ambiguity Guard · reads the table itself · Plant network — no outbound access, no API keys Ambiguity Guard reads the table itself Query Portal · offline · mobile · Plant network — no outbound access, no API keys Query Portal offline · mobile FastAPI · shopfloor.api.main · Plant network — no outbound access, no API keys FastAPI shopfloor.api.main Hybrid Retrieval · dense + lexical · RRF · Plant network — no outbound access, no API keys Hybrid Retrieval dense + lexical · RRF Answer Writer · local Qwen · triage · Plant network — no outbound access, no API keys Answer Writer local Qwen · triage Number Verifier · literal set comparison · Plant network — no outbound access, no API keys Number Verifier literal set comparison Upload Panel · /admin · Plant network — no outbound access, no API keys Upload Panel /admin parse/ · docling · page numbers · Plant network — no outbound access, no API keys parse/ docling · page numbers chunk/ · structural · Plant network — no outbound access, no API keys chunk/ structural embed/ · bge-m3, local · Plant network — no outbound access, no API keys embed/ bge-m3, local Postgres 18 · pgvector + tsvector · Plant network — no outbound access, no API keys Postgres 18 pgvector + tsvector HTTP hit or miss question matching rows top-k · RRF answer + cites upload PDF pages preserved structural chunks vectors + text dense + lexical Plant network — no outbound access, no API keys Legend Frontend Backend Database Security

Why retrieval is hybrid

  • • To an embedding, 'E-114', 'E-141' and 'E-115' sit at near-zero distance
  • • Lexical search catches the exact alarm code the operator typed
  • • RRF fuses both without calibrating two incompatible score scales

Ambiguity is not the model's call

  • • Table 4-7: M24 grade 8.8 is 720 N.m, grade 10.9 is 950 N.m
  • • Asked for 'the M24 torque', the model picks 720 with full confidence
  • • Detected on the table instead: >1 matching row, differing values, so ask

Verified, not trusted

  • • Every number, alarm code and part number must appear literally in a cited chunk
  • • If it does not, the answer is rejected — normalisation and set comparison, not a judge
  • • 56 tests, and groundcheck measures all of it against a frozen golden set