FilaOps User Guide¶

Welcome to the FilaOps user guide. FilaOps is an open-source ERP for 3D-print farms — it ties together your sales pipeline, production floor, inventory, purchasing, and accounting in one system built specifically for additive manufacturing.

This page is your map. Pick a starting point below, or jump straight to the module you need.

Where to Start¶

The App at a Glance¶

After signing in you land on the Command Center (/admin). The collapsible left sidebar groups all pages into sections. Here is what each section contains and who can see it:

The sidebar can be collapsed to icon-only width by clicking the hamburger button at the top. On mobile, the sidebar slides in as an overlay.

Daily Operations¶

These guides cover the tasks you perform most often.

Product Catalog & Manufacturing Setup¶

Set these up once and update only when you add new products or change your shop configuration.

Planning & Finance¶

Quality¶

Administration¶

Workflows & Recipes¶

End-to-end guides that show how multiple modules work together.

How the Modules Connect¶

graph TD
    A[Quotes / Sales Orders] --> B[Production Orders]
    A --> I[Invoices & Payments]
    B --> C[Inventory]
    B --> D[Work Centers & Printers]
    B --> E[Quality Inspections]
    C --> F[Buy List / Purchasing]
    F --> G[Purchase Orders]
    G --> C
    I --> H[Accounting]
    G --> H
    C --> H

A confirmed sales order can spawn a production order. The production order pulls components from inventory and routes operations through work centers (printers). The Buy List in Purchasing detects demand shortfalls across all open orders and pre-fills purchase orders for review. As orders ship and invoices are paid, accounting records revenue, COGS, and tax.

Key Pages Explained¶

Command Center¶

Route: /admin (the home screen after sign-in)

The Command Center answers "what do I need to do right now?" It shows:

• Summary cards — counts of orders awaiting action, production orders in progress, and low-stock alerts
• Prioritized action items — time-sensitive tasks sorted by urgency
• Machine status grid — one card per printer; idle printer cards display a dispatch suggestion you can confirm with a single click

Production¶

Route: /admin/production

Production orders move through a four-stage lifecycle:

1. Draft — created but not yet committed
2. Released — committed; materials are reserved
3. In Progress — actively being manufactured
4. Complete — finished and ready to fulfill

Each production order has a detail page where you record operation completions, log QC inspections (pass / fail / conditional), and record scrap with a reason code. The Operation Scheduler modal opens a scheduling board for assigning operations across work centers.

Items¶

Route: /admin/items

The item catalog supports four item types: Finished Good, Component, Material, and Supply. From the Items page you can:

• Create or edit items individually or in bulk
• Use Suggest Prices to recalculate selling prices from cost plus a target margin
• Use Duplicate Item to copy an item (and optionally its BOM) as a starting point for a new product
• Use Variant Matrix to generate a batch of color or material variants from a template item in a single operation
• Filter by type, active status, category, or stock status (shortage items shown first by default)

Bill of Materials¶

Route: /admin/bom

Each BOM is linked to a finished good or component. From the BOM detail view you can add components, specify quantities and unit of measure, view the cost rollup, and use Copy BOM to clone the structure to another product. A Create Production Order button on any BOM lets you launch production directly from the catalog.

Purchasing¶

Route: /admin/purchasing

The Purchasing page has four tabs:

• Orders — create and manage purchase orders; receive against an open PO
• Vendors — vendor contact records and purchase history
• Low Stock — items below their reorder point, with a one-click "Create PO" shortcut
• Buy List — consolidated material requirements across all open demand, with per-row "Create PO" shortcuts that pre-fill vendor and suggested quantity

Accounting¶

Route: /admin/accounting (admin only)

The Accounting page contains:

• Sales Journal — one row per invoice, with customer, amount, and status
• COGS & Materials — cost of goods sold breakdown by item and period
• Tax Center — tax collected by rate, period, and customer

Invoices are managed at /admin/invoices and payments at /admin/payments.

Quality¶

Route: /admin/quality

Shows first-pass yield, pending inspection count, scrap rate, and total inspections for the past 30 days. The inspection queue lists production orders awaiting QC; click any row to open the QC inspection modal. Recent inspections and scrap-by-reason summaries appear below.

Route: /admin/quality/traceability

Given a spool ID or lot number, traces that material through every production order it contributed to and links through to the associated sales orders.

Settings¶

Route: /admin/settings (admin only)

Key fields available in Settings:

• Company — name, address, phone, email, website
• Regional — timezone, currency code, locale (affects number and date formatting)
• Tax — enable/disable tax, default tax rate, tax name, and registration number
• Quotes — default validity period, terms text, and footer text
• Business Hours — start/end hour, days per week, and work days (used by the scheduler)
• Default Margin % — applied by the Suggest Prices tool
• Auto Dispatch — enable automatic dispatch suggestions for idle printers

Reference¶

Getting Help¶

• Issues and feature requests: GitHub Issues
• API documentation: Developer Reference
• Contributing: See CONTRIBUTING.md in the repository root

FilaOps Core | open-source (BSL) | changelog