Add TallyFlow roadmap features and update documentation

- Added Scan & Print (Mobile + Print) and Mobile + IoT integration as roadmap features in Dashboard - Updated TallyFlow User's Guide with Core integration hub note and Mobile UX details (Material 3, large buttons) - Enhanced Code Review Notes with Architecture Notes (Core as central hub) - Updated tallyflow_mobile.md with Roadmap/Integration Opportunities and UX Design sections - Updated Brochure and Go-to-Market targeting with recent GS1/FSMA Print capabilities - Added new files: tallyflow-print.md review, User's Guide, and Assets icons
2026-06-23 10:33:55 -04:00
parent d83a13f728
commit bd09036513
12 changed files with 284 additions and 5 deletions
@@ -0,0 +1,26 @@
+# TallyFlow Icons & Assets
+
+## Icons
+
+- **TallyFlow Logo (Wordmark)**  
+  `TallyFlow-Logo.png`  
+  Full horizontal logo with three-color leaf icon + "TALLYFLOW" text. Primary branding asset for website headers, marketing materials, and social posts.
+
+- **TallyFlow Product Icon (Main Logo)**  
+  `TallyFlow-Product-Icon.png`  
+  Three-color sustainability leaf (yellow, blue, green). Primary TallyFlow branding icon for general product use, website, and marketing.
+
+- **TallyFlow Print Icon**  
+  `TallyFlow-Print-Icon.png`  
+  Blue printer with sustainability leaf element. Used for TallyFlow Print module marketing and documentation.
+
+## Structure
+- Place all product/module icons in this folder.
+- Name convention: `TallyFlow-[Product]-Icon.png` or `TallyFlow-Logo.png` for the full wordmark.
+
+## Status / Notes
+- **TallyFlow Mobile**: Currently uses the main `TallyFlow-Product-Icon.png` (no dedicated Mobile icon yet).
+- **TallyFlow IoT**: No icon created yet.
+- **TallyFlow Core** and **TallyFlow Capture**: No dedicated icons yet.
+
+*This index is maintained for easy reference by the daily TallyFlow cron and marketing tasks.*
@@ -6,6 +6,9 @@
 - [ ] Develop new tallyflow.com website structure & messaging
 - [ ] Rebrand PhotoTag → TallyFlow Capture

+## Roadmap Features
+- **TallyFlow Assets (Mobile) integration with TallyFlow Print** — Enables Scan and Print workflows (e.g. on-demand label printing triggered from mobile asset scans/enrollment). Valuable for field operations where operators need to both locate/verify assets and produce/reprint tags without switching apps.
+
 ## Code Review Summary
 All core repos reviewed and documented in `Product/Code Reviews/`. Key themes:
 - Multiple overlapping implementations (Flutter, Rust, Vue, Swift) for capture/IoT/printing
@@ -17,4 +20,6 @@ All core repos reviewed and documented in `Product/Code Reviews/`. Key themes:
 - [[Product/Code Reviews/Code Review Notes]]
 - [[Marketing/Messaging/Positioning]]

-_Last updated: 2026-06-23_
+_Last updated: 2026-06-23_
+## Additional Roadmap Note (added later in session)
+- **TallyFlow Assets (Mobile) + TallyFlow IoT integration** — Real-time location, sensor data, and zone-based workflows accessible directly from the mobile app.
@@ -63,7 +63,7 @@ Automatically flag shortages, overages, and stuck assets. Turn data into action.
 Meet regulatory requirements with auditable, end-to-end tracking of perishable goods.

 **Tag Printing & Encoding**  
-Print and encode tags on demand with full integration to your workflows.
+Print and encode tags on demand with full integration to your workflows. Strong GS1-128 case label support (including GTIN-14) and dedicated FSMA 204 label templates for food traceability compliance.

 ---

@@ -36,7 +36,7 @@
 ### Segment 3: Produce & Agriculture (FSMA 204 Compliance)
 - Smaller to mid-size farms and produce distributors needing to comply with FDA FSMA 204 traceability requirements
 - Pain point: Manual or paper-based tracking that won't meet new regulatory standards
- Opportunity: Position TallyFlow as an affordable, practical RFID solution for food safety compliance
+- Opportunity: Position TallyFlow as an affordable, practical RFID solution for food safety compliance. Recent Print enhancements include dedicated FSMA 204 300dpi label templates and improved GS1-128 case label support.
 - Early proof point: Houser's Produce Farm

 ### Segment 4: 3PLs and Distribution Centers
@@ -18,4 +18,6 @@ This note will contain ongoing code review findings across the TallyFlow ecosyst
 (Notes will be added here as review progresses)

 ## Action Items
- [ ] 
+- [ ] 
+## Architecture Notes
+- **TallyFlow Core as central hub**: TallyFlow Assets (Mobile), TallyFlow Print, TallyFlow Capture, and TallyFlow IoT all integrate with TallyFlow Core (web) for asset registration, synchronization, reporting, and configuration.
@@ -0,0 +1,74 @@
+# tallyflow-print Review
+
+**Tech Stack:** Rust (Cargo)
+
+## Purpose
+Backend print service for TallyFlow Print. Handles label generation, RFID encoding, print job queuing/orchestration, and optional registration of printed assets into TallyFlow Core.
+
+## Current Capabilities (post git pull - Jun 2026)
+- Label config system with templates (simple_text, simple_text_2_5x1_25, datamatrix, etc.) and field_registry
+- Parent/child label support
+- Category names on tags
+- orgsettings integration from TallyFlow
+- Printing queue with enhanced orchestration and worker logic
+- API endpoints for job submission and status
+- Windows installation scripts and release support
+- Updates to simple tag printing including RFID
+
+## Key Components
+- **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)
+- **label_configs**: Template definitions and manifest
+- **web**: Web interface elements
+
+## Architecture (from USER_GUIDE)
+Operator → TallyFlow Print app → Print API → Print worker → Zebra printer
+                    └── (optional) Orchestrator → TallyFlow Core
+
+## Relevance
+- Backend for the TallyFlow Print ingestion method (new tag assignment + optional data association)
+- Works alongside tallyflow-print-ui (Flutter frontend)
+- Supports all tag ingestion paths that involve printing/encoding
+
+*Last updated: 2026-06-05 by Hermes Agent (after git pull using hermes_agent_ed25519 key)*
+## Recent Changes (Jun 17, 2026 pull)
+**Major theme:** GS1-128 / Case Label support + FSMA204 label templates + Windows reliability
+
+**Key additions:**
+- New `printing/src/gs1_trade_item.rs` for GS1 handling
+- New `docs/CUSTOM_LABEL.md` documentation
+- New FSMA204 300dpi label config + sample ZPL template
+- Support for multiple case types (0=each, 1-8=fixed qty, 9=variable)
+- GTIN-14 now treated as case label (starts with '1')
+- Bug fix: GS1-128 serial AI (21) now properly included
+- Voice pick algorithm correction (CRC-16)
+- Enhanced Windows install/bundle scripts
+
+**Files changed:** 29 files, +1249 insertions
+
+*Last updated: 2026-06-17 by Hermes Agent (after git pull using hermes_agent_ed25519 key)*
+
+
+## Enhancement Suggestions (from clarification - Jun 2026)
+**RFID Encoding Scope**
+- Currently limited to EPC memory bank only
+- Suggested: Add support for TID, User Memory banks
+- Suggested: Add password protection / lock bits support
+
+**Serialization & Numbering**
+- Currently customer-managed via policy (different starting serials per printer instance)
+- Suggested improvement: Allow per-printer serial number **range configuration** in Settings
+- Range should **wrap around** when the end is reached
+- Local serial tracking + increment already exists
+
+**Multi-Printer & Orchestration**
+- UI already supports multiple printers
+- Core returns error on duplicate asset registration attempts (good safeguard)
+
+*Source: Direct clarification from Todd B*
+
+## Roadmap / Integration Opportunities
+- **Mobile (Assets) integration** for Scan-and-Print workflows — Allow the mobile app to trigger print jobs (e.g., reprint, on-demand encoding during field scans or enrollment). Closes the gap between mobile asset management and the Print pillar.
+- **IoT integration** — Expose print job status/events and printer health to TallyFlow IoT for unified dashboards and alerts.
@@ -14,4 +14,11 @@ Dedicated mobile application for TallyFlow.
 This repo represents the **mobile pillar** of TallyFlow, distinct from the web, IoT, print, and capture components.

 ## Status
-Initial structure review complete.
+Initial structure review complete.
+## Roadmap / Integration Opportunities
+- Integration with **TallyFlow Print** for Scan-and-Print workflows (scan existing asset or during enrollment → trigger print job for new/replacement labels directly from mobile). Would unify field operations across Assets (Mobile) and Print components.
+- Integration with **TallyFlow IoT** for real-time location, sensor data, and zone-based workflows directly in the mobile Assets app.
+
+## UX Design
+- Built with **Material 3**
+- Large buttons prioritized for industrial/glove-friendly use in harsh environments
@@ -0,0 +1,165 @@
+# TallyFlow User's Guide
+
+**Version:** June 2026  
+**Purpose:** This guide provides an overview of TallyFlow’s full product capabilities for operators, administrators, and systems integrators.
+
+---
+
+## Overview
+
+TallyFlow is an asset tracking and management platform designed to reduce time and material waste in operations that rely on physical assets, tools, and tagged items. It combines mobile data capture, web-based core management, on-site printing/encoding, automated capture, and IoT connectivity.
+
+TallyFlow is particularly well suited for industries requiring reliable identification and traceability, including manufacturing, logistics, rail, and agriculture.
+
+**Core Value Proposition**  
+- Reduce time spent locating and managing assets  
+- Minimize material waste through better visibility and accountability  
+- Provide practical, affordable RFID, barcode, and IoT solutions for systems integrators
+
+---
+
+## Main Components
+
+### 1. TallyFlow Core (Web Application)
+The central web platform for managing assets, tags, categories, zones, and reporting.
+
+**Integration Hub:** TallyFlow Assets (Mobile), TallyFlow Print, TallyFlow Capture, and TallyFlow IoT all integrate with TallyFlow Core.
+
+**Key Capabilities:**
+- Add and manage assets manually
+- View and search tagged items
+- Import assets and tags via Excel
+- Configure categories, zones, and organizational settings
+- Reporting and exception management
+- Integration points for external systems (ERP, etc.)
+
+### 2. Mobile App (Enroll)
+Mobile application for field data capture and tag enrollment.
+
+**Key Capabilities:**
+- Enroll new tags and associate them with assets
+- Scan and update asset information in the field
+- Support for both barcode and RFID workflows
+- Works offline with later synchronization
+
+**UX Design (Industrial Focus):**
+- Built with Material 3
+- Large, glove-friendly buttons prioritized for use in harsh industrial environments
+
+### 3. TallyFlow Print
+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
+- 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
+- Support for Simple tags, GS1 case tags, parent/child tag structures
+- Category names printed on labels
+- Multiple printer management and connection testing
+- Optional automatic registration of printed items as assets in TallyFlow Core
+- Print job logging and history
+- Windows, macOS, iOS, and Android support (enhanced Windows reliability)
+
+**Backend Services:**
+- Print API (job submission)
+- Print Worker (ZPL delivery to printers)
+- Orchestrator (category/zone proxy + Core registration)
+
+### 4. TallyFlow Capture
+Automated data capture system for fixed and high-volume scanning environments.
+
+**Key Capabilities:**
+- Fixed RFID reader integration for continuous asset movement detection
+- Gateway and edge processing for real-time data collection
+- High-throughput receiving and shipping workflows
+- Exception flagging and automated alerts
+- Seamless handoff to TallyFlow Core for record updates
+
+### 5. IoT Integration
+Connectivity layer for sensors, gateways, and connected devices.
+
+**Key Capabilities:**
+- Real-time location tracking via IoT gateways and beacons
+- Environmental sensor data (temperature, humidity, shock) linked to assets
+- Automated status updates without manual scanning
+- Edge-to-cloud data pipelines feeding TallyFlow Core
+- Support for both short-range (BLE, RFID) and wide-area (LoRa, cellular) IoT networks
+
+---
+
+## Tag Ingestion Methods
+
+TallyFlow supports multiple ways to bring tags and asset data into the system:
+
+1. **Mobile App – Enroll**  
+   Field operators enroll tags directly via the mobile application.
+
+2. **TallyFlow Core (Web)**  
+   Manual asset creation with tag assignment.
+
+3. **Excel Import**  
+   Bulk import of assets and tag data via spreadsheet.
+
+4. **TallyFlow Print**  
+   On-demand tag printing and encoding with optional automatic Core registration. Supports prefix/serialization logic, parent/child relationships, and category-aware labeling.
+
+5. **TallyFlow Capture (Automated)**  
+   Fixed readers and gateways automatically detect and record tag movements.
+
+6. **IoT Devices**  
+   Sensors and connected devices push location, condition, or status data directly into the platform.
+
+---
+
+## Hardware
+
+TallyFlow is a **distributor** of Atid handheld RFID readers (such as the AT909) to systems integrators. These devices are commonly used for mobile scanning and enrollment workflows.
+
+The platform also supports fixed RFID readers, IoT gateways, and sensor devices through the Capture and IoT modules.
+
+**Note:** TallyFlow does not currently provide native support for AEI (Automatic Equipment Identification) tags used in the rail industry.
+
+---
+
+## Typical Workflows
+
+- **Asset Onboarding:** Print/encode a tag using TallyFlow Print → optionally register in Core.
+- **Field Operations:** Use mobile app to locate assets, update status, or enroll new items.
+- **Automated Receiving/Shipping:** Fixed readers (Capture) detect tagged assets moving through dock doors or checkpoints.
+- **Condition Monitoring:** IoT sensors track environmental data tied to specific assets or shipments.
+- **Bulk Operations:** Import large numbers of assets via Excel.
+- **Compliance & Traceability:** Use category, zone, tag, and IoT data for reporting and audit trails (e.g., FSMA 204 food traceability scenarios).
+
+---
+
+## Integrations
+
+TallyFlow is designed to work alongside existing systems:
+- ERP systems (JD Edwards, SAP, NetSuite, etc.)
+- Existing RFID infrastructure (Impinj, Zebra readers)
+- IoT platforms and sensor networks
+- Custom label formats via configurable templates
+
+---
+
+## Current Limitations
+
+- No native AEI rail tag support
+- TallyFlow Print requires a local print server (Print API + Worker) for production use
+- Some advanced rail-specific compliance features are not yet implemented
+- IoT and Capture modules may require additional gateway hardware and configuration
+
+---
+
+## Getting Started
+
+1. Work with your systems integrator to deploy TallyFlow Core and any required backend services (Print, Capture, IoT gateways).
+2. Configure categories, zones, and org settings in Core.
+3. Install the Mobile App, TallyFlow Print, and/or Capture/IoT components as needed.
+4. Begin enrolling, printing, or automatically capturing tagged assets using the methods that best fit your operation.
+
+For detailed Print-specific instructions, see the **TallyFlow Print – User Guide**.
+
+---
+
+*This document is maintained in the TallyFlow Obsidian vault and should be updated as new capabilities are released.*