Files
TNB 8f4ed8a306 docs: TallyFlow Scout marketing + Edge/Print/Capture feature refresh
Review tallyflow-assets-iot (TallyFlow Scout v0.5.3): Collect, Verify,
Locate with Edge remote reader / offline CSV locate. Clarify Scout does
not replace Core Assets. Refresh Edge, Print parent-container and multi-
unit identity notes, Capture share/offline/barcode notes, architecture,
use cases, capabilities, and website drafts after src/ repo pulls.
2026-07-27 15:59:32 -04:00

4.9 KiB

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-PrintShipped: mobile can trigger print jobs (reprint, on-demand encoding during field scans or enrollment).
  • Edge integration — Expose print job status/events and printer health to TallyFlow Edge 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)

Recent Changes (develop pull - 2026-07-27)

Theme: Parent container namespace + safer multi-unit retail identity + register preflight.

  • Reserve SDG RAIN assignment 8000 for parent container tags (Internal/simple CIN and part-serial reject 8000 for customer unit tags).
  • Inject per-unit AI 21 into retail GS1-128 companion barcodes (quantity > 1 no longer identical GTIN+lot barcodes).
  • Reject print-and-register when units share identity tags (post-print preflight; clear Core collision error).
  • Print UI: hide retail parent linking; require serials for multi-unit register; same 8000 parent reservation on Internal tags.

Marketing implication: Prefer concrete language — parent/container EPC namespace, unique serials on multi-unit retail companions, register blocked on duplicate identities — over vague “better serialization.”