SmartWareHouseAI / src /knowledge_base.py
Pro-Coder's picture
Upload 43 files
2d9a408 verified
Raw History Blame
11.1 kB
"""
knowledge_base.py
------------------
A small in-house knowledge base describing generic intralogistics / smart
warehouse concepts (ASRS, AGV/AMR, WMS, conveyor sorting, safety, picking
strategy). This is original written content (not scraped from any vendor
site) used purely as grounding context for the Retrieval-Augmented
Generation (RAG) pipeline that powers the AI Assistant tab.
Each entry has:
id - short unique key
title - human readable title
text - the passage used for retrieval + generation grounding
category - tag used for the retrieval evaluation set
"""
KNOWLEDGE_BASE = [
{
"id": "asrs_overview",
"title": "Automated Storage & Retrieval Systems (AS/RS)",
"category": "equipment",
"text": (
"An Automated Storage and Retrieval System (AS/RS) uses stacker "
"cranes, shuttles, or mini-load systems to automatically place "
"and retrieve pallets, totes, or cartons from high-density "
"racking. AS/RS units are typically monitored for crane cycle "
"time, load/unload faults, and rail or lift motor temperature. "
"When a crane reports a fault code, the standard response is to "
"pause the aisle, dispatch a technician, and reroute retrieval "
"jobs to an adjacent aisle if one is available."
),
},
{
"id": "agv_amr_overview",
"title": "AGVs and Autonomous Mobile Robots (AMR)",
"category": "equipment",
"text": (
"Automated Guided Vehicles (AGV) follow fixed paths such as "
"magnetic tape or wires, while Autonomous Mobile Robots (AMR) "
"navigate dynamically using LiDAR and SLAM mapping. Both are "
"used to move totes between picking stations, buffer zones, and "
"packing lines. Fleet management software assigns tasks based "
"on battery level, current queue length, and distance to the "
"target station. A vehicle blocked for more than a defined "
"timeout is automatically re-routed and flagged for review."
),
},
{
"id": "wms_overview",
"title": "Warehouse Management System (WMS)",
"category": "software",
"text": (
"A Warehouse Management System (WMS) coordinates inbound "
"receiving, put-away, inventory tracking, order picking, "
"packing, and outbound shipping. It integrates with a "
"Warehouse Control System (WCS) that talks directly to "
"conveyors, sorters, and AS/RS controllers in real time. Key "
"WMS metrics include inventory accuracy, order cycle time, and "
"pick rate (lines picked per hour)."
),
},
{
"id": "conveyor_sorting",
"title": "Conveyor and Sortation Systems",
"category": "equipment",
"text": (
"Sortation systems such as cross-belt, tilt-tray, or shoe "
"sorters route totes and parcels to the correct chute based on "
"barcode or RFID reads. Conveyor health is typically monitored "
"through motor current, belt speed, and vibration sensors. A "
"sudden rise in motor temperature combined with increased "
"vibration usually indicates bearing wear or belt misalignment "
"and should trigger a maintenance work order before a jam or "
"unplanned stoppage occurs."
),
},
{
"id": "picking_strategies",
"title": "Order Picking Strategies",
"category": "process",
"text": (
"Common picking strategies include discrete picking (one order "
"at a time), batch picking (multiple orders in one pass), zone "
"picking (pickers assigned to fixed areas), and wave picking "
"(orders released in scheduled waves aligned with shipping "
"cutoffs). Goods-to-person systems, where an AS/RS or AMR "
"brings inventory to a stationary operator, generally reduce "
"walking time and increase pick rate compared to person-to-goods "
"picking."
),
},
{
"id": "predictive_maintenance",
"title": "Predictive Maintenance in Warehouse Equipment",
"category": "maintenance",
"text": (
"Predictive maintenance uses sensor data such as motor "
"temperature, vibration amplitude, and current draw to detect "
"abnormal equipment behaviour before a breakdown occurs. "
"Machine-learning models such as Isolation Forest or "
"autoencoders are commonly trained on historical sensor "
"readings to flag anomalies. Catching a deviation early lets "
"a technician schedule maintenance during a planned downtime "
"window instead of reacting to an unplanned line stoppage."
),
},
{
"id": "safety_protocol",
"title": "Warehouse Safety Protocols",
"category": "safety",
"text": (
"Safety protocols in automated warehouses cover pedestrian "
"separation from AGV/AMR traffic lanes, lockout-tagout (LOTO) "
"procedures before entering an AS/RS aisle, and near-miss "
"incident reporting. Any near-miss or safety incident should be "
"logged immediately with the location, equipment involved, and "
"a brief description, and forwarded to the site safety officer "
"the same shift."
),
},
{
"id": "inventory_accuracy",
"title": "Inventory Accuracy and Cycle Counting",
"category": "process",
"text": (
"Inventory accuracy is usually maintained through cycle "
"counting, where a subset of SKUs or storage locations is "
"counted on a rolling schedule rather than a single annual "
"count. Discrepancies between system quantity and physical "
"quantity above a defined tolerance trigger a recount and, if "
"confirmed, an inventory adjustment transaction in the WMS."
),
},
{
"id": "kpi_overview",
"title": "Core Warehouse KPIs",
"category": "process",
"text": (
"Frequently tracked warehouse KPIs include order accuracy, "
"on-time shipment rate, dock-to-stock time, pick rate (lines "
"per hour), equipment uptime, and inventory turns. Automation "
"projects are typically justified using expected improvements "
"in throughput, labour cost per order, and space utilisation."
),
},
{
"id": "energy_efficiency",
"title": "Energy Efficiency in Automated Warehouses",
"category": "sustainability",
"text": (
"Energy use in automated warehouses can be reduced through "
"regenerative braking on AS/RS cranes and conveyors, "
"variable-frequency drives on motors that scale power to load, "
"and scheduling high-throughput operations to avoid peak "
"electricity tariff windows."
),
},
{
"id": "cross_docking", "title": "Cross-Docking", "category": "process",
"text": ("Cross-docking moves inbound goods directly from receiving to an outbound "
"shipment with little or no intermediate storage, typically staged for only a "
"few hours. It reduces inventory holding cost and handling time but requires "
"tightly synchronized inbound and outbound schedules, since a delayed inbound "
"truck can cascade into missed outbound departures."),
},
{
"id": "reverse_logistics", "title": "Returns & Reverse Logistics", "category": "process",
"text": ("Reverse logistics covers the flow of returned goods back through the warehouse: "
"inspection, grading (resellable, refurbishable, or scrap), restocking, and "
"sometimes vendor chargebacks. High e-commerce return rates make a dedicated "
"returns processing area and fast grading turnaround important for recovering "
"inventory value quickly."),
},
{
"id": "rfid_vs_barcode", "title": "RFID vs. Barcode Scanning", "category": "equipment",
"text": ("Barcode scanning requires line-of-sight to a single label and is cheap and highly "
"accurate. RFID (radio-frequency identification) can read many tags at once "
"without line-of-sight, speeding up cycle counting and dock receiving, but tags "
"cost more and dense metal racking can cause read interference. Many warehouses "
"use barcodes for unit-level picking and RFID for pallet- or case-level tracking."),
},
{
"id": "dock_scheduling", "title": "Dock Scheduling & Yard Management", "category": "process",
"text": ("Dock scheduling assigns inbound and outbound trucks to specific loading dock doors "
"and time slots to avoid yard congestion and dock-door bottlenecks. A yard "
"management system (YMS) tracks trailer location and status across the yard and "
"is often integrated with the WMS so put-away labor can be planned before a "
"trailer even arrives."),
},
{
"id": "slotting_optimization", "title": "Warehouse Slotting Optimization", "category": "process",
"text": ("Slotting assigns each SKU to a storage location based on pick frequency, size, "
"weight, and affinity with frequently co-ordered SKUs. Placing high-velocity items "
"near pack-out stations and keeping heavy items at waist height are common rules. "
"Poor slotting is one of the most common causes of excess picker travel time."),
},
{
"id": "warehouse_security", "title": "Warehouse Security & Access Control", "category": "safety",
"text": ("Warehouse security typically combines badge-based access control at building and "
"high-value-cage entry points, CCTV coverage of dock doors and aisles, and "
"shrinkage tracking (the gap between recorded and physically counted inventory). "
"High-value or regulated goods often require a separate caged area with its own "
"access log."),
},
{
"id": "labor_management", "title": "Labor Management & Workforce Scheduling", "category": "process",
"text": ("A labor management system (LMS) sets expected task times based on engineered "
"standards, tracks actual performance against them, and helps schedule headcount "
"to forecast order volume by shift. It flags tasks taking significantly longer "
"than expected, which can indicate a process problem or a training gap rather "
"than a motivation problem."),
},
]