TotalApp Docs

Shop Floor Monitor

Real-time operator terminal and supervisor dashboard — badge login, live operation tracking, issue reporting, and CSV export. Fully localised in English and Turkish.

Overview

The Shop Floor Monitor is the real-time execution view for the production floor. It has two complementary modes accessible from the toolbar: Supervisor View gives a manager a live table of every active operation with per-workstation metrics, and Operator Terminal is a kiosk-ready touchscreen for workers to log in with a badge ID, start or pause their assigned operations, record quantity produced, and report issues.

KPI Summary Row

Four cards at the top of Supervisor View: Active Operations, Paused / At Risk, Total Operators on the floor, and average Downtime in minutes. KPI values update on every data refresh.

Supervisor Operations Table

One row per active dispatch log. Shows workstation, operator name, work order, operation name, live progress bar, status badge, elapsed running time, alert icon, and inline action buttons.

Operator Terminal

Badge-scan login. After authentication the operator sees their own active operations and a list of available (unassigned) operations, with Start / Pause / Resume / Complete / Issue buttons.

CSV Export

Export all active dispatch logs to a CSV file with a single click. Column headers and the filename are locale-aware — English and Turkish are supported out of the box.

Issue Reporting

Operators can report a production issue from the terminal with a structured type (Machine Breakdown, Material Shortage, Quality Problem, Other) and a freeform description attached to the specific dispatch log.

Full Localisation

Every label, button, status badge, modal heading, elapsed-time suffix, and CSV header is localised. Turkish uses sa (hours) and dk (minutes); English uses h and m. Switch locale in Settings → General.

Quick Start

Supervisor View

  1. Open Shop Floor Monitor in the Manufacturing sidebar.
  2. The screen opens in Supervisor View by default, showing the KPI row and the operations table.
  3. Check the Paused count in the KPI cards. Operations with a non-zero downtime are highlighted At Risk.
  4. Click Export in the top-right toolbar to download a snapshot of active operations as a CSV file.
  5. Click Refresh to reload the latest data from the server at any time.

Operator Terminal

  1. Click Operator Terminal in the toolbar.
  2. The badge login screen appears. Scan a badge or type a Badge ID (e.g. B-001) and click Log In.
  3. The terminal shows the operator's Active Operations and Available Operations.
  4. Tap Start on an available operation to begin. Tap Pause on a running operation to pause it.
  5. Tap Complete to enter the final produced quantity and scrap count and close the operation.
  6. Tap Issue to report a production problem. Choose an issue type, add a description, and tap Report Issue.
  7. Tap Log Out to return to the badge login screen.

Supervisor View

KPI Cards

The four KPI cards at the top of Supervisor View give a floor-level health summary:

KPI What it measures Colour
Active Operations Count of dispatch logs currently in Running status. Cyan / sky
Paused / At Risk Count of dispatch logs in Paused status. Amber
Total Operators Number of distinct operators in the active dispatch logs. Emerald
Downtime (avg min) Average downtime in minutes across all active dispatch logs. Rose

Light Mode Compatibility

KPI card metric values use dual-tone colour classes, so they are clearly legible in both the dark Workstation theme and any light theme. There is no need to toggle a special mode for displays in brightly-lit factory environments.

Operations Table

The table below the KPI row lists every active dispatch log. Columns:

Column Content
WorkstationWorkstation name from the dispatch log.
OperatorFull name of the assigned operator.
Work OrderWork order reference number.
OperationOperation name within the work order.
ProgressHorizontal bar: qty produced as a fraction of total yield (produced + scrap).
StatusLocalised status badge — Running, Paused, Completed, or Pending.
RunningElapsed time since the operation started, shown as Xh Ym (EN) or Xsa Ydk (TR).
AlertsA warning icon appears if the dispatch log has any associated issue reports.

While data is loading on initial render, a skeleton table with six placeholder rows is shown instead of a spinner — this prevents layout shift and communicates progress clearly.

Status Badges

All status labels in the table are fully localised. The raw status string is never shown directly to the user.

StatusEnglish labelTurkish labelVisual
runningRunningÇalışıyorRunning
pausedPausedDuraklatıldıPaused
completedCompletedTamamlandıCompleted
pendingPendingBeklemedePending

Elapsed Time Format

The Running column displays elapsed time since the operation started. The format adapts to the active locale:

LocaleExampleSuffixes
English2h 35mh (hours), m (minutes)
Turkish2sa 35dksa (saat), dk (dakika)

If the elapsed time is less than one hour, only the minute portion is shown (e.g. 45m or 45dk).

Operator Terminal

The Operator Terminal is a focused, touch-friendly interface designed to run on a shared floor kiosk. It replaces the full operator roster with a single badge-login flow so each operator only sees their own work.

Badge Login

When no operator is logged in, the terminal shows a badge scan prompt. The operator can:

  • Scan a physical badge (if a hardware barcode / RFID reader is configured to emit keyboard events).
  • Type their Badge ID manually in the text field (format: B-001 through B-005 in the demo data).

Click Log In to authenticate. If the Badge ID is not found, an inline error message is shown — no page reload or redirect occurs.

Operator's Operation Lists

After login, the terminal is divided into two sections:

SectionShowsAvailable actions
Your Active Operations Dispatch logs already assigned to this operator that are Running or Paused. Pause a running operation; Resume a paused one; Complete; Report Issue.
Available Operations Dispatch logs in Pending status with no operator assigned, or assigned to this operator but not yet started. Start — begins the timer and changes status to Running.

If no operations are assigned for today, the terminal shows a localised empty-state message rather than a blank screen.

Operation Actions

Pending → Start Running → Pause Paused → Resume Running → Complete
  • Start — sets status to Running and records the start timestamp.
  • Pause — sets status to Paused; downtime counter begins accumulating.
  • Resume — sets status back to Running; downtime counter stops.
  • Complete — opens the Complete Operation modal. Enter qty produced and qty scrap, then confirm. Status moves to Completed.
  • Issue — opens the Issue Report modal at any time while the operation is active.
  • Log Out — returns to the badge login screen.

Modals

Both modals follow the standard Workstation UI pattern with the dark glass panel shell and an X close button in the header.

Issue Report Modal

Opened via the Issue button on any active operation in the operator terminal.

FieldTypeNotes
Issue Type Dropdown (select) Machine Breakdown, Material Shortage, Quality Problem, Other. Labels are fully localised — rendered via a hook that calls the translation function so the correct language is always used.
Description Textarea Freeform detail about the issue. Placeholder text is localised.

The Report Issue button shows a localised spinner (Reporting… / Raporlanıyor…) during submission. Clicking X or Cancel closes the modal without saving.

Complete Operation Modal

Opened via the Complete button. The operator enters the final quantities before closing the operation.

FieldTypeNotes
Qty Produced (live) Number input Total good units produced during this operation run.
Qty Scrap Number input Units that were rejected or scrapped. Used in the supervisor view to calculate the real progress percentage.

The Complete button shows a localised saving spinner. Clicking X or Cancel closes the modal without saving.

Progress % Calculation

In the Supervisor View operations table, the progress bar is derived from real data: round(quantityProduced ÷ (quantityProduced + quantityScrap) × 100). This means the bar accurately reflects yield — an operation that produced 90 good units and 10 scrap units shows 90%, not 100%.

CSV Export

Click the Export button in the top-right toolbar of Supervisor View to download all active dispatch logs as a UTF-8 CSV file. The file opens correctly in Excel, LibreOffice Calc, and Google Sheets without any import configuration.

Exported Columns

Column headers are localised to match the active interface language:

English headerTurkish headerContent
Workstationİş İstasyonuWorkstation name
OperatorOperatörOperator full name
Work Orderİş EmriWO reference number
OperationOperasyonOperation name
StatusDurumLocalised status string
Running (min)Çalışma (dk)Elapsed running time in minutes
Downtime (min)Duruş (dk)Total accumulated downtime in minutes

Filename

LocaleFilename
Englishshop-floor-operations.csv
Turkishuretim-sahasi-operasyonlari.csv

Excel UTF-8 Tip

The export file includes a UTF-8 BOM (Byte Order Mark) so that Excel on Windows opens Turkish characters (ş, ç, ğ, ö, ü, İ) correctly without needing a manual import wizard. Simply double-click the file to open it.

Language Support

Shop Floor Monitor is fully localised. Every visible string — including status badges, modal headings, button labels, KPI card titles, table headers, elapsed-time suffixes, and CSV column headers — is driven by the active locale selected in Settings → General → Language.

ElementEnglishTurkish
View toggle buttonsSupervisor View / Operator TerminalSüpervizör Görünümü / Operatör Terminali
KPI — active opsActive OperationsAktif Operasyonlar
KPI — pausedPaused / At RiskDuraklatıldı / Risk Altında
KPI — operatorsTotal OperatorsToplam Operatör
KPI — downtimeDowntime (avg min)Duruş (ort dk)
Status — runningRunningÇalışıyor
Status — pausedPausedDuraklatıldı
Status — completedCompletedTamamlandı
Status — pendingPendingBeklemede
Elapsed time suffixesh, msa, dk
Issue typesMachine Breakdown, Material Shortage, Quality Problem, OtherMakine Arızası, Malzeme Eksikliği, Kalite Sorunu, Diğer
Modal — issue headingIssue ReportSorun Raporu
Modal — complete headingComplete OperationOperasyonu Tamamla
Badge login promptScan your badge or enter Badge IDRozeti okutun veya Rozet Kimliğini girin

To switch locale, go to Settings → General → Language and select English or Turkish. The change takes effect immediately without a page reload.

Settings & Customisation

Setting Location Effect on Shop Floor Monitor
Language Settings → General Switches all labels, status badges, elapsed-time suffixes, modal text, and CSV headers between English and Turkish.
Screen Style Settings → Appearance Switches between dark Workstation and light Enterprise visual styles. KPI colours automatically adapt to both themes.
Enable Manufacturing Mode Settings → App Modes Adds Shop Floor Monitor (and all other MFG screens) to the left sidebar.
Manage Screens Sidebar → ⊕ icon Toggle Shop Floor Monitor on or off from the sidebar independently of other MFG screens.
Add Record Mode Settings → Appearance Controls whether new forms open as a centred modal or a right-side panel (applied globally).

AI Assistant

Select one or more production lines and open the AI Assistant panel to analyze OEE, break down downtime root causes, flag quality trends, and get production efficiency recommendations grounded in your actual shop floor data.

Click Attach Knowledge in the assistant's bottom dock to ground its answers in your My Knowledge library — your own sources, or anything a colleague has shared tenant-wide.

Frequently Asked Questions

How do operators log in on the terminal?
Switch to Operator Terminal mode using the toolbar button. The terminal shows a badge login form. The operator types or scans their Badge ID (e.g. B-001) and clicks Log In. If the badge is not found, an inline error message appears. Badge IDs are associated with operators in the employee registry — they are not passwords and do not expire.
Why does the elapsed time show different suffixes in Turkish?
The elapsed time function reads suffix tokens from the active locale translation: h and m in English, sa (saat = hour) and dk (dakika = minute) in Turkish. These suffix values are part of the same i18n system used for every other string in the application — changing language in Settings → General applies them immediately.
What does the progress bar in the operations table represent?
The bar shows yield-adjusted progress: quantityProduced ÷ (quantityProduced + quantityScrap) × 100. An operation that produced 90 good units and 10 scrap units shows 90%, not 100%. This gives supervisors an accurate picture of actual output quality, not just units touched.
The export CSV has garbled characters in Excel — how do I fix it?
The export file already includes a UTF-8 BOM, so Excel should open it correctly on Windows by double-clicking. If you still see garbled characters, try: File → Open → Browse → change "All Files" in the file type dropdown → select the CSV → use the Text Import Wizard with "UTF-8" as the encoding. On Mac, Numbers and most text editors open UTF-8 CSV without any special steps.
Can I use the Operator Terminal on a dedicated touchscreen kiosk?
Yes. Navigate to Shop Floor Monitor → click Operator Terminal in the toolbar, then press F11 for full-screen mode. The terminal is touch-friendly with large tap targets for buttons. For dedicated kiosk use, open the page in a private / incognito browser window to suppress notification prompts, and configure your OS to prevent screen sleep. Badge scanning works if your badge reader emits keyboard events (most USB HID readers do).
What issue types are available when reporting a production problem?
The Issue Report modal offers four options: Machine Breakdown, Material Shortage, Quality Problem, and Other. All four labels are fully localised — they appear in English or Turkish depending on the active locale, because the option list is built inside the modal component using the translation function rather than a fixed module-level constant.
What happens while data is loading?
Instead of a spinner or static "Loading…" text, the operations table renders a skeleton placeholder with six grey rows. This prevents layout shift and gives a clear visual signal that content is on its way. The skeleton disappears and is replaced by real data as soon as the fetch completes.