From 6db55830ee2e3cd116a399a7e32fcb0a51a1ec89 Mon Sep 17 00:00:00 2001 From: TNB Date: Tue, 7 Jul 2026 09:03:36 -0400 Subject: [PATCH] Add TallyFlow architecture diagram and description - Interactive HTML architecture diagram (Core, Assets, Print, Capture, IoT) - Markdown overview with data flows --- TallyFlow/TallyFlow-Architecture-Diagram.html | 221 ++++++++++++++++++ TallyFlow/TallyFlow-Architecture.md | 16 ++ 2 files changed, 237 insertions(+) create mode 100644 TallyFlow/TallyFlow-Architecture-Diagram.html create mode 100644 TallyFlow/TallyFlow-Architecture.md diff --git a/TallyFlow/TallyFlow-Architecture-Diagram.html b/TallyFlow/TallyFlow-Architecture-Diagram.html new file mode 100644 index 0000000..cbaceb7 --- /dev/null +++ b/TallyFlow/TallyFlow-Architecture-Diagram.html @@ -0,0 +1,221 @@ + + + + + + TallyFlow Architecture Diagram + + + + +
+
+
+
+

TallyFlow Architecture

+
+

Manufacturing Asset Tracking & RFID Workflow Platform

+
+ +
+ + + + + + + + + + + + + + + + TallyFlow Core (Backend API + Web UI) + + + + Core + FastAPI / Node.js + REST + WebSocket + + + + Assets + Asset Registry + PostgreSQL + Search + + + + Print + Label Printing + Zebra / Brother + + + + Capture + Mobile App + Janam / Zebra / Atid + Enroll & Scan + + + + IoT + Fixed Readers + Impinj / Zebra + MQTT / HTTP + + + + Database & Event Store + PostgreSQL • Redis • Time-series + Asset history, tag events, audit logs + + + + Excel Import + Bulk asset load + + + + + + API Sync + + + + CRUD + + + + Print Jobs + + + + Tag Events + + + + Persist + + + + + + + + + Legend + + + Core Backend + + + Assets / DB + + + Mobile / Frontend + + + Print Service + + + IoT / Edge + + + Data Flow + +
+ +
+
+
+
+

Core + Assets

+
+
    +
  • • Central orchestration & API layer
  • +
  • • Asset registry & lifecycle management
  • +
  • • Real-time event processing
  • +
  • • Web UI for operators & admins
  • +
+
+
+
+
+

Capture (Mobile)

+
+
    +
  • • Field enrollment & tag scanning
  • +
  • • Supports Janam XR2, Zebra, Atid
  • +
  • • Offline-first with sync
  • +
  • • Photo + GPS metadata capture
  • +
+
+
+
+
+

Print + IoT

+
+
    +
  • • On-demand label printing
  • +
  • • Fixed reader integration (Impinj/Zebra)
  • +
  • • MQTT & HTTP tag event ingestion
  • +
  • • Bulk Excel import support
  • +
+
+
+ + +
+ + \ No newline at end of file diff --git a/TallyFlow/TallyFlow-Architecture.md b/TallyFlow/TallyFlow-Architecture.md new file mode 100644 index 0000000..c938417 --- /dev/null +++ b/TallyFlow/TallyFlow-Architecture.md @@ -0,0 +1,16 @@ +# TallyFlow Architecture + +**Diagram:** [[TallyFlow-Architecture-Diagram.html]] + +## Overview + +TallyFlow's architecture is built around a central Core backend that serves as the orchestration layer for all asset tracking, RFID tag management, and workflow automation. The Assets module provides a structured registry and persistence layer (PostgreSQL-backed) for manufacturing assets, their metadata, history, and relationships. Field operations are enabled through the Capture mobile application, which runs on rugged handheld devices (Janam XR2, Zebra, Atid) to support offline-first tag enrollment, scanning, photo capture, and GPS tagging with seamless synchronization to Core. TallyFlow Print handles on-demand label generation and data association, while the IoT layer integrates fixed RFID readers (Impinj and Zebra) via MQTT or HTTP to stream real-time tag events into the platform. All components communicate through the Core API, enabling unified visibility, audit trails, and waste-reduction analytics across the manufacturing environment. Bulk data ingestion is supported via Excel import directly into Core. + +## Key Data Flows +- Capture ↔ Core: Real-time and batched sync of tag events and asset updates +- Print ↔ Core: Print job submission and confirmation +- IoT → Core: Continuous tag read events from fixed readers +- Core ↔ Assets/DB: Persistent storage of asset state and event history +- Excel → Core: Bulk asset onboarding + +This modular design allows TallyFlow to scale from mobile-only deployments to full IoT-enabled smart factories while maintaining a single source of truth in the Core. \ No newline at end of file