How justingore4/tiktok-live-tracker works
TikTok Live Tracker is a local-only Chrome side-panel extension for capturing LIVE auction activity, mapping sales to imported inventory, reconciling stock, and saving stream reports. The main workflow runs from the tracker UI through the service worker: capture reads the visible dashboard, the user maps variations and manages inventory, and ending a session creates a report that can be reviewed or exported. The README documents presets, queues, health status, and report correction/export capabilities. Sampled excerpts confirm some storage and client behavior; links for unsampled subsystems reflect documented responsibilities, not inspected call sites.
Main entry points: service-worker.js Service worker · sidepanel.js Tracker panel · content.js Dashboard capture · persistent-tagger-controller.js Tagging controller
Components 28
Auction capture
- Dashboard capture
extension/capture/content.js - Capture scheduling
extension/capture/capture-scheduler.js - Sale detection
extension/capture/sale-candidate-locator.js - Variation detection
extension/capture/bidding-variation-locator.js - Capture messaging
extension/capture/capture-client.js - Capture health
extension/capture/capture-health-reporter.js
Inventory and tagging
- Tracker panel
extension/tagger/sidepanel.js - Tagging controller
extension/tagger/persistent-tagger-controller.js - Mapping workflow
extension/tagger/mapping-workflow.js - Inventory import
extension/tagger/inventory-import-controller.js - Inventory import client
extension/tagger/inventory-import-client.js - Next-item queue
extension/tagger/next-item-queue-client.js
Session and state
- Service worker
extension/service-worker.js - Session client
extension/tagger/stream-session-client.js - Stream session
extension/shared/stream-session.js - Sales reconciliation
extension/shared/reconciliation.js - Reconciliation storage
extension/shared/reconciliation-storage.js - Session storage
extension/shared/stream-session-storage.js - Queue storage
extension/shared/next-item-queue-storage.js
Reports
- Report client
extension/report/stream-report-client.js - Report review
extension/report/report-page.js - Report export
extension/report/report-downloads.js - PDF export
extension/report/report-pdf.js - Saved reports
extension/shared/stream-report-storage.js
External integrations
- TikTok dashboard
- Google Sheets
- Chrome storage
Other components
- Tracker user
Connections 34
- Tracker user → Tracker panel: operates
- TikTok dashboard → Dashboard capture: provides visible activity
- Dashboard capture → Capture scheduling: schedules capture
- Dashboard capture → Sale detection: detects sales
- Dashboard capture → Variation detection: detects variations
- Dashboard capture → Capture messaging: reports observations
- Capture messaging → Service worker: sends events
- Service worker → Sales reconciliation: updates sales state
- Tracker panel → Tagging controller: controls mapping
- Tagging controller → Mapping workflow: creates mapping
- Tagging controller → Service worker: requests tracker state
- Tracker panel → Inventory import: manages import
- Inventory import → Inventory import client: requests preview and confirm
- Inventory import client → Service worker: sends import commands
- Service worker → Google Sheets: reads inventory
- Tracker panel → Next-item queue: manages queued item
- Next-item queue → Service worker: sends queue commands
- Service worker → Stream session: starts and ends session
- Tracker panel → Session client: requests session actions
- Session client → Service worker: sends session commands
- Service worker → Session storage: loads and saves session
- Service worker → Reconciliation storage: loads and saves state
- Service worker → Queue storage: loads and saves queue
- Session storage → Chrome storage: reads and writes
- Reconciliation storage → Chrome storage: reads and writes
- Queue storage → Chrome storage: reads and writes
- Service worker → Saved reports: saves finalized reports
- Saved reports → Chrome storage: reads and writes
- Tracker panel → Report client: opens report actions
- Report review → Report client: requests report data
- Report client → Service worker: sends report commands
- Report review → Report export: exports report
- Report export → PDF export: creates PDF
- Service worker → Capture health: records capture status