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
parent cf1e09e1c4
commit 8f4ed8a306
23 changed files with 292 additions and 151 deletions
@@ -21,6 +21,7 @@
 ## Status / Notes
 - **TallyFlow Mobile**: Currently uses the main `TallyFlow-Product-Icon.png` (no dedicated Mobile icon yet).
 - **TallyFlow Edge**: No icon created yet.
 - **TallyFlow Scout**: App icons live in `tallyflow-assets-iot` assets (not yet copied to vault Icons/).
 - **TallyFlow Core** and **TallyFlow Capture**: No dedicated icons yet.
 *This index is maintained for easy reference by the daily TallyFlow cron and marketing tasks.*
@@ -20,6 +20,10 @@ 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-07-27_
 ## Additional Roadmap Note (added later in session)
 - **TallyFlow Assets (Mobile) + TallyFlow Edge integration** — Real-time location, sensor data, and zone-based workflows accessible directly from the mobile app.
 ## Product naming (2026-07)
 - **TallyFlow Scout** (`tallyflow-assets-iot`) — Collect / Verify / Locate handheld for **Edge**. Does not replace **Assets** (Core mobile).
 - **TallyFlow Edge** — product name for former IoT; repo remains `tallyflow-iot`.
@@ -33,6 +33,9 @@ Downstream systems consume data; they do not control readers. Something has to s
 ## Benefits of TallyFlow Edge
 **Recent product notes (code review Jul 2026):** remote reader API for Scout/handhelds; reader-side filtering (validate per site); ATID ATF862 Master mode support; expanded MCP/statistics tools on develop.
 General product strengths—useful even when the conversation is not only about multi-reader fan-in.
 ### 1. Written in Rust for reliable operation
@@ -155,6 +158,7 @@ They pay for reader hardware either way. The real cost of DIY is owning multi-re
 ## Related
 - Product: TallyFlow Edge (edge service)
 - Handheld companion: **TallyFlow Scout** (Collect / Verify / Locate → Edge remote reader API or CSV; not Core Assets)
 - Egress today: **spreadsheet (CSV)**, REST API, **AMQP → TallyFlow**
 - Database today: **via app** (e.g. Alice+Olivia console → SQLite over REST), not a built-in Edge processor
 - AI today: **MCP Streamable HTTP** at `/mcp` (read-only tools; see below)
@@ -22,7 +22,7 @@ TallyFlow is the complete asset intelligence platform that combines real-time RF
 ### The TallyFlow Platform
-**Five Integrated Pillars**
+**Integrated Platform Pillars**
 | Pillar              | Description                                      | Key Benefit                     |
 |---------------------|--------------------------------------------------|---------------------------------|
@@ -30,6 +30,7 @@ TallyFlow is the complete asset intelligence platform that combines real-time RF
 | **TallyFlow Assets**| Mobile asset management app                      | On-the-floor tracking & updates |
 | **TallyFlow Capture**| Mobile photo + barcode capture (formerly PhotoTag) | Fast, accurate receiving & inspection |
 | **TallyFlow Edge**   | Reader management & real-time streaming          | Automated zone & tunnel tracking |
 | **TallyFlow Scout**  | Handheld Collect / Verify / Locate for Edge     | Floor collect, GS1 verify, offline find |
 | **TallyFlow Print** | Encoding & printing workflows                    | Consistent, error-free labeling |
 ---
@@ -15,7 +15,7 @@ This document highlights where TallyFlow is meaningfully differentiated from com
 - Few competitors offer this level of hardware abstraction
 ### 3. Unified 5-Pillar Platform
- Core (Web) + Assets (Mobile) + Capture (Photos) + Edge + Print
+- Core (Web) + Assets (Mobile) + Capture (Photos) + Edge + Scout (Edge handheld) + Print
 - Most competitors are either software-only or hardware-only
 - TallyFlow can own the full workflow from tag printing → capture → Edge → reporting
@@ -1,59 +0,0 @@
 # TallyFlow Assets for Edge
 **Status:** New component (v0.1.0+1)  
 **Primary Mobile App:** `tallyflow_mobile` remains the main TallyFlow Assets experience  
 **Role:** Companion / specialized app for Edge remote reader workflows
 ## Overview
 TallyFlow Assets for Edge is a Flutter-based mobile and desktop application that submits barcode and RFID tag reads directly to the TallyFlow Edge service using the remote reader API.
 It is designed for scenarios where tag data needs to be delivered to a local or on-premise TallyFlow Edge instance rather than going through the main TallyFlow Core mobile app.
 ## Key Positioning
 - **Complementary to `tallyflow_mobile`** — Not a replacement. `tallyflow_mobile` remains the primary app for general asset capture, enrollment, and mobile workflows.
 - **Edge-focused** — Optimized for pushing reads to the TallyFlow Edge remote reader endpoint.
 - **Hardware + Simulation** — Full hardware scanner support on Android; simulation mode on desktop for testing and demo purposes.
 ## Target Use Cases
 - Fixed or semi-fixed Edge reader workflows where a mobile device acts as a remote reader
 - Environments with local TallyFlow Edge deployments (on-prem or edge)
 - Testing and validation of remote reader configurations
 - Desktop-based simulation and automation of tag submissions during development or demos
 ## Core Features
 - Hardware barcode and RFID scanning on Android (via `flutter_hardware_scanner`)
 - Camera barcode fallback using ML Kit
 - Barcode / RFID mode switching
 - Local scan list with send status and retry
 - Manual or automatic submission to TallyFlow Edge
 - Edge service health monitoring with offline banner
 - Desktop simulator with JSON tag group loading and automation
 ## Technical Notes
 - Connects to TallyFlow Edge remote reader endpoints (`/reader/barcode` and `/reader/rfid`)
 - Requires configuration of Base URL, Remote Reader Name, and optional API key
 - Android builds require vendor AAR files for hardware scanner support
 - Desktop platforms always run in simulation mode
 ## Marketing Angle
 - Positions TallyFlow as having flexible ingestion paths (mobile app + dedicated Edge remote reader app)
 - Supports both field mobility (`tallyflow_mobile`) and Edge integration scenarios
 - Simulation mode lowers the barrier for prospects and partners to test Edge connectivity without hardware
 ## Related Components
 - `tallyflow-iot` (backend service; **product name: TallyFlow Edge**)
 - `tallyflow_mobile` (primary mobile app)
 - `flutter_hardware_scanner` (shared scanning library)
 ## Next Steps / Open Questions
 - How is this app discovered / distributed to customers?
 - Is there overlap with existing remote reader support in `tallyflow_mobile`?
 - Should this app eventually be merged, or does it serve a permanently distinct workflow?
@@ -0,0 +1,63 @@
 # TallyFlow Scout
 **Status:** Active product (app v0.5.3+10 as of July 2026 review)  
 **Repo:** `tallyflow-assets-iot` (package `tallyflow_scout`)  
 **Pairs with:** **TallyFlow Edge** (repo `tallyflow-iot`)  
 **Does not replace:** **TallyFlow Assets** (`tallyflow_mobile`) — the Core-connected mobile app for enrollment, inventory, zone moves, seek-and-find, and scan-and-print  
 ## Overview
 **TallyFlow Scout** is a Flutter handheld (and desktop demo) app for barcode and RFID work on the floor **with TallyFlow Edge**. Operators use three destinations:
 | Section | What it does |
 |---------|----------------|
 | **Collect** | Scan barcode/RFID; submit reads to Edge as a **remote reader**, or **export CSV** when Edge is offline / not configured |
 | **Verify** | Scan a GS1 barcode, then RFID tags; show whether each EPC encodes the **same GS1 identity key** (SGTIN / SSCC / GRAI / GIAI interoperability). Optional auto-confirm countdown when all match |
 | **Locate** | Seek-and-find by EPC hex, GTIN/GS1, or Internal part number with RSSI / geiger feedback — **works fully offline** (no Edge required) |
 Scout is the mobile companion for **Edge site deployments** (docks, tunnels, on-prem readers). It is **not** the full asset system of record app: enrollment, zones, Core sync, and scan-and-print remain **TallyFlow Assets**.
 ## Positioning (marketing truth)
 - **Edge path, not Core path** — Scout talks to Edge remote-reader REST (`/api/v1/reader/barcode`, `/api/v1/reader/rfid`, `/health`). Assets talks to Core.
 - **Complementary** — Sell Scout with Edge for handheld collect / verify / locate at the reader edge. Sell Assets with Core for asset lifecycle and inventory programs.
 - **Offline-capable floor tool** — Collect list + CSV export + Locate work without a live Edge server; submit when online.
 - **Hardware-real** — Android industrial scanners via `flutter_hardware_scanner` (e.g. Janam XR2, ATID, SEUIC, URFID stacks); camera barcode fallback on phones; desktop always in simulator mode for demos.
 ## Target use cases
 - Handheld remote reader into a multi-reader Edge site (same feed as fixed Impinj/Zebra readers)
 - GS1 barcode↔RFID **Verify** at encode/pack/ship (catch wrong EPC encoding before product leaves)
 - Offline **Locate** / seek-and-find on the floor without Core
 - CSV collect for demos, audits, or sites not yet wired to Edge submit
 - SI / partner demos with desktop simulator (JSON tag groups, optional automation)
 ## Core features (from product review)
 - Material 3 shell: **Collect / Verify / Locate** bottom navigation
 - Collect: pending/sent/failed status, manual batch submit or auto-send, CSV share/save (including GS1 type-filter rollup mode)
 - Verify: lists all RFID tags (no EPC soft-filter hiding mismatches); Confirm / Reset actions; swipe to Locate or delete
 - Locate: EPC mask filters (GS1 / SDG RAIN / hex / part); power slider; geiger audio; handoff from Collect/Verify swipe
 - Internal `part_serial` RFID settings aligned with **TallyFlow Print** (group Collect by part; Locate by part)
 - Edge health banner; EN + ES localization
 - Settings: base URL, remote reader name, optional API key, RFID power, scan beep, symbology filters, verify auto-confirm seconds
 ## Technical notes
 - Android package path renamed toward Scout branding (`com.tallyflow.scout`)
 - Vendor AARs for some handheld stacks live under `android/app/lib/` (see repo README); SEUIC uses on-device system libraries
 - Desktop (macOS / Linux / Windows): simulation only — load JSON tag groups, send to Edge, add to list, or export CSV
 - Service strings in code/README may still say “TallyFlow IoT”; **product name is TallyFlow Edge**
 ## Related components
 - `tallyflow-iot` — **TallyFlow Edge** backend (remote reader + fixed readers + CSV/REST/AMQP egress)
 - `tallyflow_mobile` — **TallyFlow Assets** (Core mobile; not replaced by Scout)
 - `tallyflow-print` / Print UI — Internal EPC encodings Scout can decode/group
 - `flutter_hardware_scanner` (+ XR2 / SEUIC / ATID device plugins)
 ## Open / watch
 - Website and datasheets should say **Scout + Edge**, not “Assets for IoT”
 - Distribution channel (Play / sideload / SI bundle) not fixed in vault
 - Do not market Scout as Core enrollment or scan-and-print — those stay on Assets
@@ -28,10 +28,13 @@ Mobile asset tracking and lightweight inventory. Key features include:
 Mobile photo + barcode + RFID capture (formerly PhotoTag). Processing tens of thousands of photos per week for major manufacturers like Madix (retail shelving).
 ### TallyFlow Edge
-Real-time reader management and tag streaming from Impinj, Zebra, and more.
+Real-time reader management and tag streaming from Impinj, Zebra, ATID, and more—plus remote/handheld readers.
 ### TallyFlow Scout
 Handheld **Collect**, **Verify**, and **Locate** for Edge sites. Submits to Edge as a remote reader (or CSV offline). Does **not** replace TallyFlow Assets (Core mobile).
 ### TallyFlow Print
-Tag encoding and printing workflows with full traceability.
+Tag encoding and printing workflows with full traceability—including parent/container tag rules and GS1 companion serials where configured.
 ---
@@ -50,6 +53,8 @@ Tag encoding and printing workflows with full traceability.
 - Bulk Tag Printing & Encoding
 - Produce Shipping & FSMA 204 Traceability
 - Field Asset Locate (Seek & Find)
 - GS1 Barcode↔RFID Verify (Scout)
 - Handheld remote reader into Edge (Scout)
 ---
@@ -12,7 +12,7 @@ Build a modern, professional marketing site at tallyflow.com that positions Tall
 ### 1. Home (/)
 - Hero: Strong value prop + primary CTA ("Schedule a Demo")
- Platform overview (5 pillars: Web, Mobile, Capture, Edge, Print)
+- Platform overview (Core, Assets, Capture, Edge, Scout, Print)
 - Key benefits / proof points
 - Featured use cases (Receiving, Zone Movement, Exception Management)
 - Trust bar (industries + logos if available)
@@ -27,6 +27,7 @@ Build a modern, professional marketing site at tallyflow.com that positions Tall
 - /assets — TallyFlow Assets (Mobile) — mobile asset management app
 - /capture — TallyFlow Capture (Photos) — mobile + photo + barcode (formerly PhotoTag)
 - /edge — TallyFlow Edge (reader management, real-time streaming)
 - /scout — TallyFlow Scout (Collect / Verify / Locate handheld for Edge; not Assets)
 - /print — TallyFlow Print (encoding & printing workflows)
 ### 4. Solutions
@@ -37,6 +37,7 @@ Add or emphasize these capabilities on the TallyFlow page:
 ## Stretch Goal: Update the main TallyFlow page to focus on the 5 components:
 * TallyFlow Core (Web)
 * TallyFlow Edge
 * TallyFlow Scout (Collect / Verify / Locate — Edge handheld; not Assets)
 * TallyFlow Capture
 * TallyFlow Mobile
 * TallyFlow Print
@@ -13,6 +13,7 @@
  - TallyFlow Core
  - TallyFlow Capture
  - TallyFlow Edge
  - TallyFlow Scout
  - TallyFlow Print
 - Use Cases / Solutions
 - Case Studies
@@ -76,7 +77,7 @@
 - Make the Capture product page the strongest right now (it has the most supporting content)
 - Ensure mobile experience is excellent (many use cases are field-based)
 - Include clear CTAs on every page: “Request Demo” and “Start Free Trial”
- Plan for future expansion into Core, Edge, and Print (keep navigation flexible)
+- Plan for future expansion into Core, Edge, Scout, and Print (keep navigation flexible)
 - Use consistent tagging/categorization language across the site
 ---
@@ -41,6 +41,7 @@
 ### Feature Highlights to Emphasize
 - TallyFlow Edge (fixed infrastructure / tunnels)
 - TallyFlow Scout (handheld Collect / Verify / Locate into Edge; not Core Assets)
 - TallyFlow Capture (photo + barcode association)
 - TallyFlow Print (tag printing + registration)
 - Seamless ERP integration via keyboard wedge or API
@@ -13,6 +13,7 @@ This note will contain ongoing code review findings across the TallyFlow ecosyst
 - [x] tallyflow-print (print/encoding backend)-ui
 - [x] tallyflow_spreadsheet_importer (Flutter spreadsheet import tool)
 - [x] flutter_tallyflow_iot_rest_client (Flutter REST client for Edge)
 - [x] tallyflow-assets-iot (**product: TallyFlow Scout**; Collect/Verify/Locate for Edge) — [[tallyflow-scout]]
 ## General Observations
 (Notes will be added here as review progresses)
@@ -11,4 +11,7 @@ iOS implementation of PhotoTag (now TallyFlow Capture) — mobile photo + barcod
 - Has submission docs (README-SUBMISSION.md)
 ## Note on Duplication
-This is one of several implementations of capture functionality (compare to tallyflow-decode Flutter and phototag-web).
+This is one of several implementations of capture functionality (compare to tallyflow-decode Flutter and phototag-web).
 ## Jul 2026 pull notes
 - Offline categories cache; connection settings usable with Admin Lock; category filter; diagnostics upload with Admin PIN; multi-capture crash/race fixes; session counter persistence.
@@ -10,4 +10,8 @@ Web interface for PhotoTag (TallyFlow Capture).
 - Likely mirrors some of tallyflow-web's asset/photo workflows
 ## Note on Duplication
-Vue implementation of capture features that overlap with tallyflow-web. Good candidate for consolidation or clear branding separation in the new tallyflow.com site.
+Vue implementation of capture features that overlap with tallyflow-web. Good candidate for consolidation or clear branding separation in the new tallyflow.com site.
 ## Jul 2026 pull notes
 - **v2.2.x public share collections** — create/edit public shares, combine mode, SDG branding on public list, download/open fixes.
 - Market as controlled external photo sharing for Capture web, not a full DAM.
@@ -1,33 +1,39 @@
 # TallyFlow Edge Review (repo: tallyflow-iot)
-**Tech Stack:** Rust (Cargo workspace) + Leptos (web UI)
+**Product name:** TallyFlow Edge (repo/package still `tallyflow-iot`)  
 **Tech stack:** Rust (Cargo workspace) + Leptos CSR web UI  
 **Branches reviewed:** `develop` through `81fa9d8` (July 2026 pull)
 ## Structure
 - `core/`: Main service/library
  - RFID drivers (Impinj, Zebra, ATID ATF862 / Invengo XC-RF861 — same reader rebranded)
  - Barcode support (Zebra, SNAPI)
  - REST API v1
  - Real-time tag streaming
  - Reader config/control
  - Runs as an always-on Windows or Linux service
 - `web/`: Leptos CSR web interface
  - Reader health monitoring
  - Live tag streaming with filtering
  - Start/stop controls
  - Imports types directly from `core` (no duplication)
-## Key Capabilities
+- `core/` — service/library  
- Hardware abstraction for multiple RFID vendors
+  - RFID drivers: Impinj, Zebra, **ATID ATF862 / Invengo XC-RF861 (Master mode)**  
- Real-time data pipeline from readers → REST → web UI
+  - Barcode: SNAPI / Aurora / wedge paths  
- Designed for always-on Edge deployment
+  - **Remote reader** REST API (mobile/handheld submit — used by **TallyFlow Scout**)  
- Strong documentation (REST_API.md, LIBRARY.md, etc.)
+  - REST API v1, live tag streaming, reader start/stop/health  
  - **Reader-side filtering** (for quotes such as RMS tunnel/filter needs — validate in field)  
  - Keyboard wedge + optional lookup filter (e.g. Assa Abloy patterns)  
  - Egress processors: CSV logger, REST, AMQP → TallyFlow  
  - **MCP** Streamable HTTP at `/mcp` (health, readers, tags; statistics-oriented skills expanded)  
  - Windows Service install path  
 - `web/` — Leptos UI: reader health, live stream/filter, start/stop, improved statistics display  
-## Relevance to TallyFlow Platform
+## Key capabilities (market carefully)
 - Primary ingestion layer for RFID/Edge data
 - Feeds the web app, reporting, and exception systems
 - Complements tallyflow-web (which consumes the data)
-## Next Steps for Review
+- Multi-vendor fixed RFID + remote/handheld readers under one site edge  
- Inspect `core/src/` for reader driver implementations
+- Unified tag feed → CSV / REST / AMQP  
- Review REST API endpoints in REST_API.md
+- Ops UI without vendor tools  
- Check web/ Leptos components for UI patterns
+- MCP read-oriented copilot surface (not autonomous dock control by default)  
 - Companion handheld: [[TallyFlow Scout]] (Collect / Verify / Locate)
 ## Relevance
 - Primary **site edge** ingestion for docks, tunnels, and multi-reader plants  
 - Can feed Core via AMQP; can stand alone with CSV/REST and customer apps (e.g. Alice+Olivia console)  
 - Scout is the supported mobile remote-reader experience for Edge  
 ## Next review steps
 - Confirm shipped MCP tool list vs docs after statistics/MCP skill commits  
 - Document ATF862 Master mode hardware prerequisites  
 - Field-test reader-side filtering before strong marketing claims  
@@ -85,3 +85,15 @@ Operator → TallyFlow Print app → Print API → Print worker → Zebra printe
 - 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.”
@@ -0,0 +1,43 @@
 # TallyFlow Scout Review (repo: tallyflow-assets-iot)
 **Product name:** TallyFlow Scout  
 **Package:** `tallyflow_scout`  
 **Version reviewed:** 0.5.3+10 (master `2c479fb`, July 2026)  
 **Tech stack:** Flutter (Material 3), `flutter_hardware_scanner`, optional camera barcode (ML Kit), HTTP client to Edge  
 ## Role in platform
 Handheld **Collect / Verify / Locate** app for **TallyFlow Edge**.  
 **Not** a replacement for **TallyFlow Assets** (`tallyflow_mobile` → Core).
 ## Destinations
 1. **Collect** (nav key still `navUpdate` in l10n) — scan list, submit to Edge remote reader API or export CSV  
 2. **Verify** — GS1 barcode identity vs RFID EPC encodings (`gs1_verify_match`); optional auto-confirm  
 3. **Locate** — offline seek-and-find / geiger (`locate_screen`, RSSI colors aligned with Assets pick-list palette)
 ## Integration
 - Client: `lib/services/tallyflow_iot_client.dart` → `{baseUrl}/api/v1/health`, `/reader/barcode`, `/reader/rfid`
 - Remote reader must exist on Edge (`type = remote`, enabled); reader name must match Settings
 - Offline: Collect + CSV + Locate without server; banner when Edge unreachable
 ## Hardware
 - Android industrial devices via hardware scanner plugin (XR2, ATID AARs, SEUIC, URFID noted in tree)
 - Camera barcode fallback when no hardware scanner / init failure
 - Desktop: simulator always on
 ## Notable modules
 - `epc_mask.dart`, `sdg_rain_decode.dart` — EPC type / Internal part decode  
 - `scan_csv_exporter.dart` — CSV share/save  
 - `l10n` — English + Spanish  
 - Tests cover EPC mask, GS1 verify match, locate finds, CSV export, symbology filter  
 ## Marketing guardrails
 - Say **Scout works with Edge**; **Assets works with Core**
 - Three sections only: Collect, Verify, Locate  
 - Locate offline is a real differentiator for floor find without Core  
 - Do not claim full asset CRUD, zones, or scan-and-print in Scout  
@@ -1,6 +1,6 @@
 # TallyFlow User's Guide
-**Version:** June 2026  
+**Version:** July 2026  
 **Purpose:** This guide provides an overview of TallyFlow’s full product capabilities for operators, administrators, and systems integrators.
 ---
@@ -29,7 +29,7 @@ TallyFlow is particularly well suited for industries requiring reliable identifi
 ### 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 Edge all integrate with TallyFlow Core.
+**Integration hub (Core):** TallyFlow Assets (Mobile), TallyFlow Print, and TallyFlow Capture integrate with TallyFlow Core. **TallyFlow Edge** can feed Core (e.g. AMQP) or stand alone (CSV/REST). **TallyFlow Scout** connects to **Edge**, not Core, and does not replace Assets.
 **Key Capabilities:**
 - Add and manage assets manually
@@ -43,14 +43,17 @@ The central web platform for managing assets, tags, categories, zones, and repor
 - 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)
+### 2. TallyFlow Assets (Mobile)
-Mobile application for field data capture and tag enrollment.
+Core-connected mobile app for field asset work (`tallyflow_mobile`). **This is not TallyFlow Scout.**
 **Key Capabilities:**
 - Enroll new tags and associate them with assets
 - Scan and update asset information in the field
 - Lightweight inventory with optional zone moves
 - Geiger-style seek & find for one or many assets
 - **Scan-and-print** — trigger Print jobs from mobile enrollment/scan workflows
 - Support for both barcode and RFID workflows
- Works offline with later synchronization
+- Works offline with later synchronization to Core
 **UX Design (Industrial Focus):**
 - Built with Material 3
@@ -64,7 +67,11 @@ Desktop and mobile application (Flutter) paired with a Rust backend service for
 - 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
- Support for Simple tags, GS1 case tags, parent/child tag structures
+- Support for Internal tags, GS1 case tags, parent/child tag structures
 - **Parent container tags:** SDG RAIN assignment **8000** reserved for parent/container namespace (customer internal tags cannot use 8000)
 - Retail GS1-128 companion barcodes can inject **per-unit AI (21)** serials so multi-unit jobs are not identical GTIN+lot barcodes
 - Print-and-register **rejects** jobs when units would share identity tags (blocks Core collisions)
 - CSV part-catalog import for parts + quantities to print
 - Category names printed on labels
 - Multiple printer management and connection testing
 - Optional automatic registration of printed items as assets in TallyFlow Core
@@ -77,29 +84,38 @@ Desktop and mobile application (Flutter) paired with a Rust backend service for
 - Orchestrator (category/zone proxy + Core registration)
 ### 4. TallyFlow Capture
-Automated data capture system for fixed and high-volume scanning environments.
+Mobile photo documentation linked to barcodes, RFID, jobs/orders, and categories (formerly PhotoTag). iOS + Android apps with web review.
 **Key Capabilities:**
- Fixed RFID reader integration for continuous asset movement detection
+- Capture photos tied to scanned IDs and categories
- Gateway and edge processing for real-time data collection
+- Offline-friendly capture with later upload (categories cacheable; GPS fallback when address lookup fails)
- High-throughput receiving and shipping workflows
+- Library / detail review; full-resolution viewing
- Exception flagging and automated alerts
+- **Public share collections** (web) for controlled external photo access
- Seamless handoff to TallyFlow Core for record updates
+- Android: barcode symbology selection in Settings; highlight scanned barcodes
 - Integrates with Core for tagged photo visibility where deployed
 ### 5. TallyFlow Edge
-Connectivity layer for sensors, gateways, and connected devices. Runs as an always-on Windows or Linux service.
+Site edge service for fixed and remote RFID/barcode readers. Runs as an always-on Windows or Linux service (repo `tallyflow-iot`).
 **Key Capabilities:**
- Real-time location tracking via Edge gateways and beacons
+- Multi-reader management (e.g. Impinj, Zebra fixed readers; ATID ATF862 Master mode where supported)
- Environmental sensor data (temperature, humidity, shock) linked to assets
+- Unified tag stream with ops UI (start/stop, health, statistics)
- Automated status updates without manual scanning
+- **Remote reader API** for handhelds — used by **TallyFlow Scout**
- Edge-to-cloud data pipelines feeding TallyFlow Core
+- Reader-side filtering (site-specific; validate before promising)
- Support for both short-range (BLE, RFID) and wide-area (LoRa, cellular) IoT networks
+- Egress: CSV/spreadsheet, REST, AMQP → TallyFlow Core
- RFID GPIO support for reader triggers and control
+- Keyboard wedge (+ optional lookup) into focused ERP/apps
- Endpoint configuration available for Edge and Mobile readers
+- MCP read tools for AI copilots (health/readers/recent tags — not autonomous dock control by default)
- ERP integration via keyboard wedge, database integration, and spreadsheet output
+- Compatible with Core in cloud or on-premises, or standalone without Core
- Optional custom receiving or shipping user interface that integrates with an ERP system
+
- Compatible with TallyFlow Core deployed in the cloud or on-premises
+### 6. TallyFlow Scout
 Handheld Flutter app for **Edge** floors (`tallyflow-assets-iot`). **Does not replace TallyFlow Assets.**
 **Three sections:**
 - **Collect** — scan barcode/RFID; submit to Edge as a remote reader, or export CSV offline
 - **Verify** — GS1 barcode vs RFID EPC identity match (SGTIN/SSCC/GRAI/GIAI-style)
 - **Locate** — seek-and-find by EPC/GTIN/part with geiger feedback; works offline without Edge
 **Hardware:** Industrial Android scanners (e.g. Janam XR2, ATID, SEUIC, URFID); camera barcode fallback; desktop simulator for demos. EN/ES UI.
 ---
@@ -107,8 +123,8 @@ Connectivity layer for sensors, gateways, and connected devices. Runs as an alwa
 TallyFlow supports multiple ways to bring tags and asset data into the system:
-1. **Mobile App – Enroll**  
+1. **TallyFlow Assets (Mobile)**  
-   Field operators enroll tags directly via the mobile application.
+   Field operators enroll, inventory, locate, and scan-and-print against Core.
 2. **TallyFlow Core (Web)**  
   Manual asset creation with tag assignment.
@@ -119,11 +135,11 @@ TallyFlow supports multiple ways to bring tags and asset data into the system:
 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)**  
+5. **TallyFlow Capture**  
-   Fixed readers and gateways automatically detect and record tag movements.
+   Photo + barcode/RFID documentation into Capture/Core workflows.
-6. **Edge Devices**  
+6. **TallyFlow Edge (+ Scout)**  
-   Sensors and connected devices push location, condition, or status data directly into the platform.
+   Fixed readers and Scout handheld Collect submit into the site edge feed (CSV/REST/AMQP/Core as configured).
 ---
@@ -131,7 +147,7 @@ TallyFlow supports multiple ways to bring tags and asset data into the system:
 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, edge gateways, and sensor devices through the Capture and Edge modules.
+The platform also supports fixed RFID readers through **TallyFlow Edge**, and handheld industrial scanners for **Assets** and **Scout**.
 **Note:** TallyFlow does not currently provide native support for AEI (Automatic Equipment Identification) tags used in the rail industry.
@@ -140,9 +156,9 @@ The platform also supports fixed RFID readers, edge gateways, and sensor devices
 ## 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.
+- **Field Operations (Core):** Use **Assets** to locate assets, update status, enroll, or scan-and-print.
- **Automated Receiving/Shipping:** Fixed readers (Capture) detect tagged assets moving through dock doors or checkpoints.
+- **Field Operations (Edge):** Use **Scout** Collect / Verify / Locate with Edge remote reader or offline CSV/locate.
- **Condition Monitoring:** IoT sensors track environmental data tied to specific assets or shipments.
+- **Automated Receiving/Shipping:** Fixed readers via **Edge** detect tagged assets at docks/tunnels; Scout can add handheld reads to the same site feed.
 - **Bulk Operations:** Import large numbers of assets via Excel.
 - **Compliance & Traceability:** Use category, zone, tag, and Edge data for reporting and audit trails (e.g., FSMA 204 food traceability scenarios).
@@ -14,6 +14,7 @@ TallyFlow gives operations teams a practical way to **tag, scan, locate, documen
 | **Assets** | Mobile inventory, enrollment, zone moves, seek-and-find, and **scan-and-print** |
 | **Capture** | Mobile photo capture linked to barcodes, RFID, job/order IDs, and categories |
 | **Edge** | Fixed RFID readers and tunnels—unified multi-reader feeds, health, and control |
 | **Scout** | Handheld Collect / Verify / Locate for Edge (not a Core Assets replacement) |
 | **Print** | On-demand barcode & RFID label printing and encoding (Zebra / ZPL-compatible) |
 **End-to-end flow:** print & encode → scan or auto-read → photo proof → exceptions & reports → ERP / BI handoff
@@ -45,7 +46,7 @@ TallyFlow gives operations teams a practical way to **tag, scan, locate, documen
 - **Unified stack** — Web, mobile, fixed RFID, print, and photo in one family—not five disconnected tools  
 - **Hardware flexible** — Works with leading RFID readers (e.g. Impinj, Zebra) and industrial printers  
 - **ERP-friendly** — Complements your system of record; does not force a rip-and-replace  
- **Modular start** — Capture, Print, or Edge can stand alone; Assets + Core when you need full asset control  
+- **Modular start** — Capture, Print, or Edge (+ Scout) can stand alone; Assets + Core when you need full asset control  
 - **Proven operations** — Manufacturing, repair/MRO, logistics, retail, and produce / food traceability  
 ---
@@ -56,7 +57,7 @@ TallyFlow gives operations teams a practical way to **tag, scan, locate, documen
 |------------------|-------------|
 | Freight claims or QC photos | **Capture** |
 | On-demand tags & FSMA/GS1 labels | **Print** (+ **scan-and-print** with Assets) |
-| Tunnel / multi-reader RFID | **Edge** |
+| Tunnel / multi-reader RFID | **Edge** (+ **Scout** handheld) |
 | Tool find, counts, zone visibility | **Assets + Core** |
 | Full receive → track → document | **Full platform** |
@@ -14,6 +14,7 @@ TallyFlow gives operations teams a practical way to **tag, scan, locate, documen
 | **Assets** | Mobile inventory, enrollment, zone moves, seek-and-find, and **scan-and-print** |
 | **Capture** | Mobile photo capture linked to barcodes, RFID, job/order IDs, and categories |
 | **Edge** | Fixed RFID readers and tunnels—unified multi-reader feeds, health, and control |
 | **Scout** | Handheld Collect / Verify / Locate for Edge (not a Core Assets replacement) |
 | **Print** | On-demand barcode & RFID label printing and encoding (Zebra / ZPL-compatible) |
 **End-to-end flow:** print & encode → scan or auto-read → photo proof → exceptions & reports → ERP / BI handoff
@@ -45,7 +46,7 @@ TallyFlow gives operations teams a practical way to **tag, scan, locate, documen
 - **Unified stack** — Web, mobile, fixed RFID, print, and photo in one family—not five disconnected tools  
 - **Hardware flexible** — Works with leading RFID readers (e.g. Impinj, Zebra) and industrial printers  
 - **ERP-friendly** — Complements your system of record; does not force a rip-and-replace  
- **Modular start** — Capture, Print, or Edge can stand alone; Assets + Core when you need full asset control  
+- **Modular start** — Capture, Print, or Edge (+ Scout) can stand alone; Assets + Core when you need full asset control  
 - **Proven operations** — Manufacturing, repair/MRO, logistics, retail, and produce / food traceability  
 ---
@@ -56,7 +57,7 @@ TallyFlow gives operations teams a practical way to **tag, scan, locate, documen
 |------------------|-------------|
 | Freight claims or QC photos | **Capture** |
 | On-demand tags & FSMA/GS1 labels | **Print** (+ **scan-and-print** with Assets) |
-| Tunnel / multi-reader RFID | **Edge** |
+| Tunnel / multi-reader RFID | **Edge** (+ **Scout** handheld) |
 | Tool find, counts, zone visibility | **Assets + Core** |
 | Full receive → track → document | **Full platform** |
@@ -28,9 +28,10 @@ TallyFlow is a unified asset intelligence platform with five integrated componen
 | Component | Role |
 |-----------|------|
 | **TallyFlow Core** | Web dashboard for assets, zones, categories, reporting, exceptions, and integrations |
-| **TallyFlow Assets** | Mobile app for inventory, enrollment, zone moves, seek-and-find, and **scan-and-print** |
+| **TallyFlow Assets** | Mobile app for inventory, enrollment, zone moves, seek-and-find, and **scan-and-print** (works with **Core**) |
 | **TallyFlow Capture** | Mobile photo + barcode/RFID capture for documentation and claims |
-| **TallyFlow Edge** | Fixed RFID readers, tunnels, and real-time tag streaming at the dock or line |
+| **TallyFlow Edge** | Fixed RFID readers, tunnels, multi-reader site edge, and real-time tag streaming |
 | **TallyFlow Scout** | Handheld **Collect / Verify / Locate** companion for **Edge** (does **not** replace Assets) |
 | **TallyFlow Print** | On-demand barcode and RFID label printing and encoding (including jobs triggered from mobile) |
 Together they cover the full path from **print a tag → scan or read it → document condition → report exceptions → connect to your ERP**, including **scan-and-print** from the field (enroll or locate an asset and print/encode a label without switching apps).
@@ -369,6 +370,24 @@ Together they cover the full path from **print a tag → scan or read it → doc
 ---
 ### 18b. Handheld Collect, Verify & Locate with TallyFlow Scout (Edge)
 **Pain authenticity (internal):** `Real` — Floor teams need a simple handheld to feed the site edge, check barcode↔RFID identity, and find a tag without standing up full Core mobile.
 **Also called:** remote reader handheld, GS1 RFID verify, seek-and-find offline
 **Problem:** Fixed readers cover portals; people still walk the floor with handhelds. Wrong EPC encodings slip through when barcode and RFID are not checked together. Full Core asset apps are heavier than a dock verify/find job.
 **How TallyFlow helps:**
 - **Collect** — scan barcode/RFID on industrial Android devices (or camera barcode on a phone); submit to **TallyFlow Edge** as a remote reader, or export **CSV** when Edge is offline
 - **Verify** — scan a GS1 barcode, then RFID tags; confirm each EPC encodes the same GS1 identity key (SGTIN/SSCC/GRAI/GIAI-style interoperability). Optional auto-confirm when the list is all matches
 - **Locate** — seek-and-find by EPC, GTIN/GS1, or Internal part with RSSI/geiger feedback; works **offline** without Edge or Core
 - Does **not** replace **TallyFlow Assets** (Core enrollment, inventory, zones, scan-and-print)
 **Typical fit:** Edge sites, SI demos, encode/pack verify, floor find next to tunnels/portals.
 ---
 ### 19. Condition & Environmental Monitoring (Edge)
 **Pain authenticity (internal):** `Watch-overclaim` — Cold-chain and handling damage are real. Lead only where sensor-linked deployments are actual and repeatable.
@@ -390,7 +409,7 @@ Together they cover the full path from **print a tag → scan or read it → doc
 | Use case | Pain authenticity (internal) | Primary TallyFlow components | Typical industries |
 |----------|------------------------------|------------------------------|--------------------|
-| Receiving & inbound verification | **Real** | Edge, Assets, Core | Distribution, retail, manufacturing |
+| Receiving & inbound verification | **Real** | Edge, Scout, Assets, Core | Distribution, retail, manufacturing |
 | Shipping & outbound verification | **Real** | Edge, Capture, Assets, Core | Manufacturing, 3PL, produce |
 | Cycle counting | **Real** | Assets, Core | Warehouse, MRO, food distribution |
 | Physical inventory & stock audits | **Real** | Assets, Capture, Core | Any inventory-heavy operation |
@@ -406,7 +425,7 @@ Together they cover the full path from **print a tag → scan or read it → doc
 | Compliance audits | **Real-but-packaged** | Core, Capture | Regulated and audited ops |
 | Field document capture | **Real** | Capture | Multi-site sales and logistics |
 | Field installation tracking | **Real-but-packaged** | Capture | Field equipment, controls |
-| Dock-door & tunnel automation | **Real** | Edge, Core | High-volume DCs |
+| Dock-door & tunnel automation | **Real** | Edge, Scout, Core | High-volume DCs |
 | ERP / BI integration | **Watch-overclaim** | Core, Edge | ERP-centric enterprises |
 | Condition monitoring | **Watch-overclaim** | Edge, Core | Cold chain, sensitive goods |
@@ -2,22 +2,23 @@
 **Diagram:** [[TallyFlow-Architecture-Diagram.html]]
-## Overview (5 Components)
+## Overview
-TallyFlow is built around exactly **five primary components**, with **Core** as the central hub that owns the database.
+TallyFlow is built around **Core** as the central hub that owns the database, plus field and site modules. **Scout** is an Edge companion handheld, not a sixth Core-connected peer equal to Assets.
 ### 1. Core (Central)
 - **Core Backend** (Go) positioned in the center — provides the REST API
 - **Core Web UI** (Vue.js) on the left — consumes the Core API
 - **Auth Service** — handles login and SSO support
 - Owns MongoDB (assets, tags, photos, zones, events)
- Single API integration point for all other components
+- Single API integration point for Core-connected components
 - Handles configuration, reporting, and orchestration
 ### 2. Assets (Mobile)
- Flutter native mobile application
+- Flutter native mobile application (`tallyflow_mobile`)
- Lightweight inventory, geiger-style seek & find, enrollment, zone moves
+- Lightweight inventory, geiger-style seek & find, enrollment, zone moves, **scan-and-print**
- Communicates with Core via REST/WebSocket API
+- Communicates with **Core** via REST/WebSocket API
 - **Not the same product as Scout**
 ### 3. Print
 - Flutter + Rust implementation
@@ -25,25 +26,36 @@ TallyFlow is built around exactly **five primary components**, with **Core** as
 - Includes **Print UI** for configuration
 - Can also be driven directly via the **Print API**
 - **Can register assets directly with Core**
 - Parent container EPC namespace (SDG RAIN assignment 8000); multi-unit retail companion AI 21; register preflight against duplicate identities
 ### 4. Capture (PhotoTag)
- Native mobile application (not Go/Vue)
+- Native mobile applications (iOS/Android) + web
 - Associates photos with barcodes, work orders, and metadata
 - Focused on quality control and visual documentation
- Sends data to Core via API
+- Public share collections on web (controlled external access)
 - Sends data to Core via API where deployed
 ### 5. Edge
- Rust-based service
+- Rust-based site edge service (repo `tallyflow-iot`; **product name TallyFlow Edge**)
- Integrates fixed RFID readers (Impinj, Zebra, ATID ATF862 / Invengo XC-RF861 — same reader rebranded) and environmental sensors
+- Fixed RFID readers (Impinj, Zebra, ATID ATF862 / Invengo XC-RF861 where supported)
- Pushes tag events and sensor data to Core (optional / dashed connection)
+- Remote reader REST API for handhelds
- **Can integrate with ERP systems**
+- Unified multi-reader feed → CSV / REST / AMQP → Core (optional)
 - Keyboard wedge, ops UI, MCP read tools
 - **Can integrate with ERP systems** without requiring Core
 ### 6. Scout (Edge companion handheld)
 - Flutter app **TallyFlow Scout** (repo `tallyflow-assets-iot`)
 - **Collect / Verify / Locate**
 - Submits to **Edge** remote reader API (or CSV offline); Locate works offline
 - **Does not replace Assets** and does not talk to Core as the asset app
 **MongoDB** is not a standalone component — it is fully owned and managed inside Core.
 ## Data Flows
- **Assets, Print, Capture** → Core: Solid lines (primary flows)
+- **Assets, Print, Capture** → Core: Solid lines (primary Core flows)
- **Edge → Core**: Dashed line (optional, event-driven)
+- **Scout** → **Edge**: Solid (remote reader / site feed)
 - **Edge → Core**: Dashed line (optional, event-driven AMQP/etc.)
 - **Print** additionally supports asset registration back into Core
- Core Web UI communicates with Core Backend via the same API used by other components
+- Core Web UI communicates with Core Backend via the same API used by other Core clients
-All external modules interact exclusively through Core’s REST API layer.
+Core-connected modules interact through Core’s REST API layer. Edge/Scout may operate standalone for site RFID programs.