Skip to main content

OpSee Documentation

OpSee is a Manufacturing Execution System (MES) for OEE (Overall Equipment Effectiveness) tracking, analysis, and optimization. It runs entirely on-premises, with no cloud dependency and no internet required.

:::tip New to OpSee or MES? Discover OpSee in 10 minutes: a guided tour through OEE and MES fundamentals, using Production Line A as a concrete example. No setup, no configuration, just read and explore. :::

How this documentation is organized​

The OpSee documentation is built around two pillars:

PillarQuestion it answersSections
🔧 UseHow do I use this feature?Quick Start, User Guide
🧠 UnderstandWhat does this concept mean? Why does it matter?Concepts, Glossary

Two additional sections support contributors and maintainers:

  • Architecture: how OpSee is built, services, database, authentication, ingestion
  • Developer Guide: how to run OpSee locally and contribute

Pick your path​

I am an Operator or Supervisor​

You spend your day on the shop floor, watch real-time OEE on a dashboard, log downtime reasons, and validate stop events.

  1. Read OEE Fundamentals to understand what the numbers mean
  2. Open the Cockpit to build your personal dashboard
  3. Use Production for OEE monitoring and downtime tracking

I am a Manager or Plant Director​

You own the OEE numbers across lines and shifts, identify top losses, and drive improvement projects.

  1. Read OEE Fundamentals for the calculation methodology
  2. Build executive dashboards in the Cockpit
  3. Review OEE Configuration to see how losses are categorized

I am a Plant Administrator​

You set up the system after the integrator hands it over, configure equipment, personnel, recipes, and access control.

  1. Start with Equipment to model your plant hierarchy
  2. Configure Personnel, Material, and OEE Configuration
  3. Set up Procedures and Recipes
  4. Manage Administration (access control, audit, localization)

I am a Developer or Integrator​

You extend OpSee, add custom integrations, run it locally, and contribute back.

  1. Read Data Flow to understand the pipeline from sensor to dashboard
  2. Follow the Local Development Setup guide
  3. Explore the Architecture deep dive

Documentation map​

What is OEE?​

OEE measures manufacturing productivity with three multiplicative factors:

OEE = Availability × Performance × Quality
  • Availability: was the equipment running when it should have been?
  • Performance: was it running at full speed?
  • Quality: were all products good?

An OEE of 85% or more is considered world-class. Most manufacturers start around 60%. Read the full explanation in OEE Fundamentals.

Key capabilities​

  • Real-time OEE monitoring with auto-refresh dashboards
  • Customizable Cockpit with drag-and-drop widgets
  • AI Assistant powered by Claude, ask questions about your data in natural language
  • Equipment hierarchy following ISA-95 and ISA-88 standards
  • Downtime tracking with reason trees and root cause analysis
  • Production orders linked to recipes and procedures (ISA-88)
  • Personnel management with shifts, crews, and schedules
  • Material tracking with equipment assignments
  • Comprehensive audit trail for regulatory compliance
  • Multi-language support (10 languages)
  • Offline-first, runs entirely on-premises with no internet
  • Open integrations for MQTT, OPC-UA, Node-RED, Grafana

Next steps​

  • Glossary: definitions of every key term used in OpSee
  • Architecture Overview: how the platform is built