Docs/Getting started
VYRAB HANDBOOK

Getting started

Sign in, understand roles and find your way around the workspace.

Start with your workspace

Vyrab connects product definitions and customer orders with planning, shop-floor work, quality, warehouse operations and cost calculation.

  1. Open erp.vyrab.com.
  2. Sign in with the login and password supplied by your administrator. Public website access does not create an ERP account.
  3. Check which sections are available to your role. If a section is missing, ask your administrator to check your access.
  4. Use Settings to choose your language, theme and navigation position.

For a first production workflow, define a product and its routing in Products & orders, create a production order, check materials in Warehouse & supply, then plan and publish assignments in Production & planning. Record completed work and quality decisions in Work & quality.

Roles and permissions (RBAC)

Permissions are granted not to an individual operator but to a role; an operator can be assigned several roles at once. The boundary is drawn at the level of a menu item (not a group, not an individual action within a page), with a few exceptions for operations that require narrower authority than simply "can see the section."

Role Typical task Main permissions
Administrator System setup, users All permissions (*)
Area foreman Runs production for their entire area Parts, orders, schedule, assignments, work intake, QC, defects, contracts, order fulfillment, supply availability — view and manage
Dispatcher Planning and flow control for orders Orders, schedule, assignments, scheduler (view + manage), order fulfillment, supply availability
QC inspector Quality acceptance, recording defects Work intake (view), QC marks, defects
Shop floor operator Submits completed work Work intake (view)
Storekeeper Runs warehouse operations MRP, supply availability, warehouse, limit cards, arrivals
Procurement officer Purchasing and arrivals Supply availability, arrivals, orders (view)
Process engineer Maintains parts and routings Parts (view)
Cost accountant Cost accounting and time tracking Cost, timesheet (including for all employees)

Several operations are protected by a separate permission inside a section, distinct from the permission to view the section itself:

  • QC mark (qc.write) — separate from viewing the "Work intake" tab / "Defects" page: an ordinary shop floor operator can see and accept work, but only someone with this permission can record the QC result.
  • Reversing a work record (work-records.correct) — retroactively cancels an erroneous entry, separate from an ordinary submission — held by the Area foreman and Administrator.
  • Publishing a scheduler run (scheduler.publish) — creates real shift work assignments on the shop floor, separate from viewing the schedule (scheduler.view).
  • Changing flow settings (scheduler.manage) — buffers, WIP limits, locks, POLCA pairs — separate from simply viewing Dispatch/Flow management.

Outside these four cases the application has no "view/act" split within a single page — if a role can see a section, it can perform every action in it.

Interface: windows, navigation, object inspector

The workspace is built as a virtual desktop (based on dockview): every menu section opens as a separate panel/tab, several panels can be placed side by side, dragged, closed, and reopened independently of each other. The list of open windows is in the windows menu in the top-right corner (OpenWindowsMenu).

The menu on the left (or top — toggled in Settings) is grouped into 6 groups, each the subject of a separate phase of this documentation:

  1. Overview — dashboard (opens by default on sign-in).
  2. Analytics — consolidated production analytics.
  3. Production — flow management, dispatch, parts, orders, production schedule, assignments, detailed schedule, contracts, order fulfillment, work intake, defects.
  4. Accounting — cost, price list, timesheet.
  5. Warehouse — MRP, supply availability, warehouse, limit cards, arrivals.
  6. Reference data — all administrative reference data and the activity log.

A menu item is visible only if the operator has permission for it; if, after filtering by permissions, no items remain in a group, the whole group is hidden (rather than opened empty).

Separately from section windows there is an object inspector — clicking an entity (a part, an order, a routing step, etc.) in any section can open that specific object's card/table/link graph/relation graph in a separate panel, without leaving the current screen. This is a second, independent family of panels (unlike section panels — one panel per open object, rather than one per section).

Shop floor terminal (Kiosk)

A separate full-screen mode with no menu or windows — for installation on a shop-floor PC/terminal, where the worker only accepts and submits assignments (WorklistPage/KioskPage, more detail in Work & quality).

Settings

Personal interface settings (Reference data → Settings, available to any signed-in user): interface language (Russian/English), theme (dark/light), navigation placement (left/top). Stored in the operator's browser, and do not affect other users.

Glossary of terms

Term Meaning
Part An entry in the reference data: an assembly, a part, a material, or a purchased item (the kind field)
BOM Bill of materials — the nesting tree of parts within one another (bom_item, with a quantity and unit on each relation)
Operation A routing step for a part: the place where it is performed, the standard time (Tman, hours), the rate, the sequence order
Production order An order to manufacture a batch of a product; lifecycle: planning → in production → done/canceled
Schedule item (WorkOrder) A specific part/assembly within a production order, with its own quantity and start date
Order routing step (OrderOperationStep) A specific assignment to perform one operation within a schedule item; statuses: pending → in progress → done
Work record (WorkRecord) An immutable log entry recording that a worker submitted a given quantity for a given step in a given shift
Tman The standard labor intensity of an operation, in hours per unit/batch — the basis for computing time and labor cost
K1/K2/K3 Correction coefficients for material consumption norms and price (inherited from the original VOGBIT formulas)
MRP Material requirements planning — how much of what needs to be purchased/produced for the current order portfolio
POLCA / buffer / WIP limit Pull-based flow planning tools (Flow management/Dispatch) — limit the amount of work in progress between places
Limit-and-issue card A document for repeated issue of material from the warehouse to the shop floor within an established limit
QC Quality control department — quality acceptance of completed work, recording of defects

All subsequent documentation chapters reference the roles and terms described here. See all guides for the full list of phases.