Pantry · System Architecture
Phase 1 built · Phase 2 planned · Updated 2026-03-29
CLIENTS & PRESENTATION Lerato browser Thabo mobile browser Grace Phase 2 REACT WEB APP (Vite) Cloudflare Pages · pantry-app.tapfumamv.com Dashboard stock · expiry · alerts Inventory CRUD · filter · search Scan Receipt upload · review · sync Shopping List auto · manual · in-store Budget monthly · category · store Household members · roles · invites Recipes Sprint 5 Intelligence Sprint 5 Email Import Sprint 5 WhatsApp Bot Thabo · Grace stock queries · list updates Phase 2 Voice / Nest Hub Google Actions "Do I have rice?" Phase 2 BACKEND SERVICES Supabase Auth Email + password JWT sessions · magic link Role-based access (RLS) PostgreSQL Database osmtvniihyxpkadjvyur.supabase.co · households · household_members · inventory_items · baseline_stock · categories · receipts · budget_periods · recurring_items · shopping_lists Sprint 5 · recipes Sprint 5 RLS · all tables Edge Functions Supabase · Deno runtime Receipt OCR Handler calls GCV → parses → inserts items Inventory Sync CRUD · baseline deviation check Shopping Trigger low-stock → list auto-add Sprint 5 below Prediction Engine consumption rate → restock date Email Order Parser Sixty60 · Woolies Dash email HA Webhook Receiver sensor signal → threshold eval Google Cloud Vision OCR · receipt text extraction LINE_DETECTION · confidence score vision.googleapis.com Cloudflare Pages CDN Static build · global edge pantry-app.tapfumamv.com Gmail API order confirmation emails Sixty60 · Woolies Dash parsing Sprint 5 Push Notifications low stock · expiry · threshold alert Phase 2 IOT LAYER — PHASE 2 (MELISSA'S HARDWARE STACK) Weight Nodes ×3 D1 Mini + HX711 5 kg / 50 kg load cells WiFi → MQTT Distance Sensor VL53L0X ToF Laser Shelf presence detection I2C → D1 Mini → MQTT Zigbee Buttons SONOFF Dongle MG21 Manual stock trigger Raspberry Pi 5 Hub Home Assistant automations · threshold rules · UI MQTT Broker Mosquitto · sensor message bus Zigbee2MQTT Dongle bridge · device pairing HA REST / Webhook Client POSTs to Pantry Edge Fn on trigger Melissa's Existing Stack "Automate what you can. The rest is left to human intervention." · Weight sensors under canisters · Liquid sensors in bottle caps · Zigbee press-buttons for manual triggers · HA fires WhatsApp + Nest Hub queries today · Pantry app becomes her output & approval layer HTTPS / REST served via CDN PostgreSQL SQL/RLS HTTPS POST OAuth · fetch Realtime trigger MQTT HTTPS POST LEGEND Phase 1 (built) Phase 2 (planned) Realtime / WebSocket MQTT (IoT) Sprint 5 scope Phase 2 scope