SmartShelf – Python Application Architecture

This technical note summarizes the internal architecture and design logic of SmartShelf, a PyWebIO-based interactive pantry management system. The focus is on structural design, dispatch logic, and data-driven UI rendering.

Architecture Overview

SmartShelf follows a simple layered structure:

CSV Storage → Pandas DataFrames → Utility Layer (pantry_utils)
            → UI Rendering (PyWebIO) → User Interaction → Data Update

• Data Layer: CSV files loaded into Pandas DataFrames.
• Logic Layer: Business logic abstracted in pantry_utils.
• UI Layer: PyWebIO button-driven dynamic rendering.
• Controller: Dispatcher table mapping menu → handler functions.

Core Design Pattern – Dispatcher Model

The application uses a dispatch table to map UI choices to handler functions. This enables modular expansion without altering core control flow.

choice_handlers = {
    'View Pantry': render_pantry,
    'Edit Pantry Quantities': render_edit_pantry,
    'Add to Pantry': render_pantry_update,
    ...
}

Dynamic UI Rendering via Scope

Instead of static page reloads, SmartShelf uses scoped rendering:

clear_scope('main')
with use_scope('main'):
    put_table(...)

This creates a lightweight reactive behavior similar to modern frontend frameworks.

Safe Input Mapping Strategy

To dynamically generate forms, item names are sanitized:

safe_name = re.sub(r'\W+', '_', item['item_name'])

This prevents invalid variable binding and ensures safe dictionary mapping.

SmartShelf – Extension Module (Additional Technical Note)

As an extension to this index, the full SmartShelf implementation can be treated as a standalone applied Python architecture example.

1. Architecture Overview (SmartShelf)
2. Design Pattern & Dispatcher Model
3. Pantry Data Flow & State Management

↩ Go to EDA Portfolio

↩ Go to Home-Tech Notes Park