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.
This commit is contained in:
TNB
@@ -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
|
||||
- Hardware abstraction for multiple RFID vendors
|
||||
- Real-time data pipeline from readers → REST → web UI
|
||||
- Designed for always-on Edge deployment
|
||||
- Strong documentation (REST_API.md, LIBRARY.md, etc.)
|
||||
- `core/` — service/library
|
||||
- RFID drivers: Impinj, Zebra, **ATID ATF862 / Invengo XC-RF861 (Master mode)**
|
||||
- Barcode: SNAPI / Aurora / wedge paths
|
||||
- **Remote reader** REST API (mobile/handheld submit — used by **TallyFlow Scout**)
|
||||
- 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
|
||||
- Primary ingestion layer for RFID/Edge data
|
||||
- Feeds the web app, reporting, and exception systems
|
||||
- Complements tallyflow-web (which consumes the data)
|
||||
## Key capabilities (market carefully)
|
||||
|
||||
## Next Steps for Review
|
||||
- Inspect `core/src/` for reader driver implementations
|
||||
- Review REST API endpoints in REST_API.md
|
||||
- Check web/ Leptos components for UI patterns
|
||||
- Multi-vendor fixed RFID + remote/handheld readers under one site edge
|
||||
- Unified tag feed → CSV / REST / AMQP
|
||||
- Ops UI without vendor tools
|
||||
- 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
|
||||
Reference in New Issue
Block a user