Add TallyFlow marketing assets (hero photos, IoT/Print screenshots); update code reviews (IoT, Print, Web), website requirements doc, user's guide, and screenshots README

2026-07-10 08:19:54 -04:00
parent 803c563716
commit 7aed88908e
15 changed files with 24 additions and 12 deletions
@@ -12,6 +12,12 @@ This folder is for organizing app and web screenshots used for the TallyFlow web
 - **TallyFlow Core/**
  - Web dashboard and admin screenshots
 - **TallyFlow Print/**
  - Printer setup and label printing screenshots (TSC/Printronix hardware)
 - **TallyFlow IoT/**
  - Fixed RFID readers, tunnels, and gateway hardware
 ## Guidelines
 - Use descriptive filenames (e.g., `capture-android-job-detail.png`, `capture-ios-freight-claim.png`)
@@ -13,12 +13,12 @@
 - Push/transition assets between zones
 - Time-in-zone visibility and alerts
 - **Zone notifications**: Send notifications on zone exceptions (e.g., asset in zone too long)
- **Zone delete events**: Automatically delete assets or remove tags after a period when an asset enters a zone (supports tag recycling/reassignment; asset can remain while tag is reassigned). Extensible to parent/child relationships (e.g., tote asset remains but children are removed from the parent)
+- **Zone delete events** for automatic tag recycling/reassignment
 - **Parent/child asset handling** (asset can remain while children/tags are detached)
 ### 3. ERP Integration
- Optional keyboard wedge / direct injection into ERP
+- Primary: TallyFlow IoT using keyboard wedge, database integration, and spreadsheet output
- Import of expected data from spreadsheets / AWBs
+- Additional opportunities in TallyFlow Core using the API and webhooks
 - Writing received data back to ERP tables
 ### 4. Tag Printing & Encoding
 - Custom RFID tag encoding (ASCII, proprietary)
@@ -9,7 +9,7 @@
  - REST API v1
  - Real-time tag streaming
  - Reader config/control
-  - Can run as Windows service
+  - Runs as an always-on Windows or Linux service
 - `web/`: Leptos CSR web interface
  - Reader health monitoring
  - Live tag streaming with filtering
@@ -19,7 +19,7 @@ Backend print service for TallyFlow Print. Handles label generation, RFID encodi
 - **api**: Main API service (port 8040)
 - **orchestrator**: Proxies categories/zones and runs "print then register" flows (port 8041)
 - **printing**: Core label generation and ZPL handling
- **worker**: Pulls jobs and sends to Zebra printers (raw TCP 9100)
+- **worker**: Pulls jobs and sends to Zebra and compatible ZPL printers (raw TCP 9100)
 - **label_configs**: Template definitions and manifest
 - **web**: Web interface elements
@@ -13,7 +13,8 @@
 - RFID / IoT integration points
 - Reporting & exports
 - User workflows (receiving, movement, printing)
- ERP integration surface
+- ERP integration surface (API and webhooks)
 - Photo display and filtering with tags (Capture integration)
 ## Initial Observations
 - **Core Entities**: Things (assets), Zones, Maps, Organizations, Users, Reports, Exceptions, Webhooks, API Keys.
@@ -38,8 +38,10 @@ The central web platform for managing assets, tags, categories, zones, and repor
 - Configure categories, zones, and organizational settings
 - Reporting and exception management
  - Zone notifications: configurable Alert Time (minutes) + email recipients for exceptions (e.g. asset in zone too long)
-  - Zone delete events: Delete Delay (hours), Delete Immediately checkbox, and Delete Behavior (killMode) for automatic asset/tag removal or recycling on zone entry. Supports parent/child relationships (children can be detached while parent asset remains)
+  - Zone delete events for automatic tag recycling
- Integration points for external systems (ERP, etc.)
+  - Parent/child asset handling (children can be detached while parent asset remains)
 - Core web can display and filter photos with tags (integration with Capture app)
 - Integration points for external systems (ERP via API and webhooks)
 ### 2. Mobile App (Enroll)
 Mobile application for field data capture and tag enrollment.
@@ -58,7 +60,7 @@ Mobile application for field data capture and tag enrollment.
 Desktop and mobile application (Flutter) paired with a Rust backend service for printing and encoding labels.
 **Key Capabilities:**
- Print and encode RFID + barcode labels on Zebra printers
+- Print and encode RFID + barcode labels with ZPL support on Zebra and compatible printers
 - Strong **GS1-128 / Case Label** support (GTIN-14 treated as case labels, proper AI (21) serial handling)
 - Dedicated **FSMA 204** 300dpi label templates and ZPL configs for food traceability compliance
 - Pre-configured **workflow profiles** for popular use cases including **FSMA**, **SSCC** (Serialized Shipping Container Code), and internal-use barcode/RFID labeling
@@ -84,8 +86,8 @@ Automated data capture system for fixed and high-volume scanning environments.
 - Exception flagging and automated alerts
 - Seamless handoff to TallyFlow Core for record updates
-### 5. IoT Integration
+### 5. TallyFlow IoT
-Connectivity layer for sensors, gateways, and connected devices.
+Connectivity layer for sensors, gateways, and connected devices. Runs as an always-on Windows or Linux service.
 **Key Capabilities:**
 - Real-time location tracking via IoT gateways and beacons
@@ -94,6 +96,9 @@ Connectivity layer for sensors, gateways, and connected devices.
 - Edge-to-cloud data pipelines feeding TallyFlow Core
 - Support for both short-range (BLE, RFID) and wide-area (LoRa, cellular) IoT networks
 - RFID GPIO support for reader triggers and control
 - Endpoint configuration available for IoT and Mobile readers
 - ERP integration via keyboard wedge, database integration, and spreadsheet output
 - Optional custom receiving or shipping user interface that integrates with an ERP system
 - Compatible with TallyFlow Core deployed in the cloud or on-premises
 ---