Operations Intelligence Platform

A reproducible operations intelligence control tower for fragmented manufacturing data.

The project connects S&OP demand, BOM records, inventory exports, finished goods, customer orders, inbound shipment data, customs/policy signals, release notices, line simulation results and agent tool calls into one local demo. The public version uses only synthetic data and generic product families, so it can be inspected without private factory systems.

中文摘要：这是一个面向制造运营的通用智能总控项目。它把产销存、需求预测、BOM 覆盖、成品库存、供应商状态、海关政策信号、放行通知、产线仿真和 Agent 工具轨迹放进同一套可复现的数据链路里，所有公开数据均为合成样例。

Showcase page: docs/showcase.html

What It Demonstrates

Capability	Evidence in this repo
S&OP control tower	build_control_tower_overview, demo_data/demand_history.json, demo_data/product_economics.json
Forecast and model adapter boundary	forecast_demand, TimesFM-ready time-series contract, GET /api/forecast/demand
External policy radar	demo_data/policy_signals.json, search_policy_signals, official-source adapter contract
Decision brief	generate_decision_brief, owner/action/evidence lanes, deterministic-tool-first model boundary
Release gate workbench	build_release_gate, material/capacity/policy/quality/source/approval checks, GET /api/release-gates/{order_id}
Scenario profile library	demo_data/scenario_profiles.json, reusable assembly, fulfillment, service-kit and quality-lab operating profiles
Spreadsheet and export intake	demo_data/file_imports.json, parser labels, import dashboard
BOM and material readiness	BOM explosion, inventory coverage, source-row trace
Release notice generation	HTML/JSON notice preview from order, product and material gate
Line takt and bottleneck analysis	Deterministic 24h simulation over configurable machine nodes
Agent-readable operations tools	Tool registry, workflow routing, tool calls and source refs
Adapter-ready boundaries	ERP/WMS/MES/PLC/scheduling/MCP mock or stub contracts

Default Scenario

The main scenario follows FG-OPS-A100, a synthetic modular control kit. The wider data pack also includes a sensor pack, fluid service kit and inspection fixture so the model is not tied to one product category.

Reusable scenario profiles live in demo_data/scenario_profiles.json:

• manufacturing-assembly: demand to material gate, capacity, release and trace.
• warehouse-fulfillment: order promise, pick readiness, carrier plan and shipment release.
• maintenance-kit: service demand, kit completeness, vendor ETA and dispatch gate.
• quality-lab: sample intake, test capacity, hold decision and release evidence.

demo_data
  -> parser and seed scripts
  -> SQLite demo database
  -> deterministic domain engines
  -> FastAPI operations API
  -> generated frontend snapshot
  -> React operations console
  -> agent tool registry and workflow trace

Quick Start

Requirements:

• Python 3.11+
• Node.js 20.19+ or 22+

git clone https://github.com/Felix-Zuo/factory-ops-intelligence-platform.git
cd factory-ops-intelligence-platform
python -m pip install -r apps/api-server/requirements.txt
npm --prefix apps/web-dashboard install
python scripts/seed_demo_data.py
python scripts/generate_frontend_snapshot.py

Start the API:

$env:PYTHONPATH="apps/api-server"
python -m uvicorn factory_ops_api.main:app --host 127.0.0.1 --port 8017

Start the dashboard:

npm --prefix apps/web-dashboard run dev -- --host 127.0.0.1 --port 5178

Or start both services:

.\scripts\run_dev.ps1

Run the full validation suite:

npm run test:all

The full check seeds demo data, regenerates the frontend snapshot, runs self-checks, runs pytest, runs the smoke demo, scans user-facing copy and builds the web dashboard.

Screenshots

BOM and inventory	Release gate

Material trace	Line simulation

Operations Q&A	Integration status

Runtime Modules

Module	Current behavior
S&OP Control Tower	Open demand, 4-week forecast, finished-goods cover, material gate, capacity, value and action status
Forecast Lab	Deterministic demand forecast with TimesFM-ready interface shape
Policy Radar	Official-source customs/policy signals linked to materials, products and orders
Decision Brief	Source-backed actions, evidence lanes and model safety boundary
Release Gate	Combines material, capacity, policy, quality, source-trace and human approval controls before notice export
Scenario Profiles	Shows reusable operating profiles for manufacturing, fulfillment, service parts and quality review
Data Import Center	Classifies demo files, parser status, source rows and quality flags
BOM & Inventory	Explodes BOM demand into material coverage, inbound records, supplier notes and shortage watch
Product Material Trace	Links product, BOM, stock, inbound, order, supplier and source refs
Release Notice Generator	Builds a notice preview from product, order, BOM, material gate and template version
Line Simulation	Runs deterministic 24h output, utilization, waiting, blocking, scrap and bottleneck checks
Simulation Report	Summarizes line output, bottleneck, quality risk and machine-level metrics
Operations Q&A	Selects intent and workflow, calls registered tools and returns source-backed output
Integration Status	Shows ERP/WMS/MES/PLC/scheduling/MCP mode and current gaps
Agent Trace	Shows tool calls, inputs, source refs and execution order

Architecture

apps/api-server         FastAPI operations API
apps/web-dashboard      React operations console
packages/core-domain    Shared domain boundary
packages/parsers        Import parser boundary
packages/engines        Deterministic calculation boundary
packages/integrations   Adapter contracts
packages/agent-runtime  Tool registry and trace boundary
demo_data               Synthetic manufacturing records
database                SQLite schema and seed target
tests                   Domain, API, trace and snapshot checks
scripts                 Seed, smoke, tone scan, snapshot and validation

The dashboard can run from a generated snapshot, so reviewers can inspect the UI without keeping the API process alive. Backend functions still produce the same values used by the smoke demo and tests.

Project History

This repository is an independent public demo that consolidates several operation-tooling directions:

• spreadsheet export intake and standardized records;
• release notice generation from a structured order payload;
• line takt simulation and bottleneck reporting;
• manufacturing data-model examples for BOM, stock, supplier and traceability;
• S&OP control-tower modeling for demand, stock, capacity, policy and cash;
• forecast interface design compatible with TimesFM-style time-series models;
• official-source external signal adapters for customs and policy changes;
• release-gate governance across material, capacity, quality, policy, traceability and approval;
• reusable scenario profiles for non-single-category operations demos;
• source-backed agent workflows with tool-call evidence.

See PROJECT_HISTORY.md for the detailed capability map and release trail.

Public Data Boundary

Keep production exports, customer lists, supplier lists, real BOMs, shipment plans, screenshots with company identifiers and logs out of the repository unless they have been intentionally sanitized.

Live integrations are represented by mock/stub/sample adapters. Credentials and live system URLs do not belong in this repo.

Documentation

• Project history
• Architecture
• Data contract
• Demo script
• Roadmap
• Product requirements
• Technical analysis
• Quality standard
• Release notes v0.3.1
• Release notes v0.3.0
• Changelog
• Contributing
• Security

License

MIT. See LICENSE.