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 and compatible ZPL 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.

Recent Changes (develop branch pull - July 2026)

Major theme: CSV import for batch printing, GS1 Sunrise dual-carrier retail tags, custom field registration, internal profile standardization.

Key additions from develop:

Add import and database lookup via a CSV file for a list of parts and quantities to print (supports batch workflows).
Initial support for retail GS1 Sunrise dual-carrier tags.
Custom field registration support (bumped versions to 0.8.0 / 1.3.0).
Add org custom fields to TallyFlow registration UI.
Update profile name and id from 'simple' to 'internal'.
Additional bug fixes and profile enhancements.

Last updated: 2026-07-17 by Hermes Agent (after develop pull using hermes_agent_ed25519 key)

4.1 KiB Raw Blame History