How krishna99-tech/smartkitchen works
KitchenOS combines dual-ESP32 kitchen hardware, an AWS serverless backend, a Flutter mobile client, and an administrative portal. The documented device workflow provisions a gateway, publishes scale telemetry, processes it in cloud functions, persists kitchen state, and updates connected clients; scheduled jobs also send reminders and reports. Admin pages cover device, inventory, activity, logs, users, settings, and reporting. Firmware and backend source excerpts are partial, and Flutter/Dart implementation files were not present in the supplied tree, so some subsystem links rely on the README architecture.
Main entry points: index.js Unified Backend · flutterapp Flutter App · reminders.js Scheduled Reminders · NetworkManager.cpp Network Gateway
Components 23
Kitchen Hardware
- Scale Sensors
firmware/main_ble/Nodes/KitchenOS_NodeA_UI/SensorManager.cpp - Scale UI Node
firmware/main_ble/Nodes/KitchenOS_NodeA_UI/CommsManager.cpp - Network Gateway
firmware/main_ble/Nodes/KitchenOS_NodeB_Net/NetworkManager.cpp - Device State
firmware/main_ble/Nodes/KitchenOS_NodeB_Net/StorageManager.cpp
Cloud Platform
- Fleet Provisioning
aws/lambdas/index.js - AWS IoT Core
- Unified Backend
aws/lambdas/index.js - Analytics
aws/lambdas/analytics.js - Nutrition
aws/lambdas/nutrition.js - Report Generation
aws/lambdas/reports.js - PDF Reports
aws/lambdas/pdf_report.js - Scheduled Reminders
aws/lambdas/reminders.js - GraphQL API
aws/schema.graphql - WebSocket API
aws/lambdas/ws.js - Kitchen Data
- Cognito Auth
- Scheduled Events
- FCM and SES
Client Apps
- Flutter App
flutterapp
Administration
- Admin Console
admin_portal/app - Admin Actions
admin_portal/lib/actions - Admin PDF Reports
admin_portal/lib/actions/pdf_report.ts
Other components
- Kitchen User
Connections 23
- Scale Sensors → Scale UI Node: sends readings
- Scale UI Node → Network Gateway: UART exchange
- Network Gateway → Fleet Provisioning: requests provisioning
- Fleet Provisioning → AWS IoT Core: provisions device
- Network Gateway → AWS IoT Core: publishes telemetry
- AWS IoT Core → Unified Backend: triggers
- Unified Backend → Kitchen Data: reads and writes
- Unified Backend → Analytics: uses analytics
aws/lambdas/index.js - Unified Backend → Nutrition: uses nutrition
aws/lambdas/index.js - Unified Backend → Report Generation: uses reports
aws/lambdas/index.js - Report Generation → PDF Reports: generates PDFs
aws/lambdas/reports.js - Unified Backend → WebSocket API: pushes updates
- Unified Backend → Scheduled Reminders: invokes asynchronously
- Scheduled Events → Scheduled Reminders: invokes on schedule
- Scheduled Reminders → Kitchen Data: reads kitchen data
- Scheduled Reminders → FCM and SES: sends reminders
- Flutter App → Cognito Auth: authenticates
- Flutter App → GraphQL API: queries and subscribes
- Flutter App → WebSocket API: receives live updates
- Flutter App → FCM and SES: receives push
- Kitchen User → Flutter App: uses
- Admin Console → Admin Actions: uses actions
- Admin Actions → Admin PDF Reports: requests reports
admin_portal/lib/actions/reports.ts