OX-Labs-Africa/agent-stock-eyes

Intelligent stock auditing, reconciliation, variance investigation, and evidence-based reporting. # Agent Stock Eyes **Agent Stock Eyes** is an intelligent, evidence-led stock-auditing platform that reconciles purchases, receipts, supplier invoices, sales, physical inventory, documented leakage, and other stock movements to identify variances and generate traceable audit reports. ## The problem Stock audits are often conducted across spreadsheets, disconnected documents, physical count sheets, and verbal explanations. This makes it difficult to determine: * What was ordered, received, invoiced, sold, or consumed. * What stock should remain at a specific cutoff time. * Whether apparent shortages are explained by physical stock, leakage, authorized consumption, or other movements. * Which inconsistencies require investigation. * How to turn audit work into a quantified, evidence-supported report. Agent Stock Eyes is intended to guide this entire process in one auditable workspace. ## Core audit journey The system follows stock from its source to its final outcome: 1. Purchase order. 2. Goods receipt and acceptance. 3. Supplier invoice. 4. Storage and departmental transfers. 5. Production, conversion, or portioning. 6. Sale or authorized consumption. 7. Physical stock count. 8. Documented wastage, damage, or spoilage. 9. Unresolved shortages or unexplained overages. 10. Investigation, evidence capture, findings, and reporting. ## Planned capabilities * Business item and unit-of-measure master data. * Mother-item, child-item, recipe, portion, and yield relationships. * CSV and spreadsheet ingestion. * Intelligent item and field-mapping suggestions. * Deterministic unit conversion and stock reconciliation. * Purchase-order, receipt, and invoice matching. * Sales-versus-stock analysis. * Physical stock reconciliation by location and department. * Documented leakage and authorized non-sales movement analysis. * COGS, gross-margin, conversion-rate, and financial-impact calculations. * Prioritized anomalies and control exceptions. * Item-level investigation wor …