""" 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."), }, ]