Skip to content
invento-software-limitedPublic

About

EPCForge is a Frappe app that provides comprehensive Engineering, Procurement, and Construction (EPC) management for Frappe/ERPNext including BOQ, Budgeting, Tendering, and Document Control. πŸš€

Resources

Stars

7 stars

Watchers

1 watching

Forks

Latest commit

Β 

History

17 Commits

Folders and files

Repository files navigation

EPCForge Logo

EPCForge

Engineering, Procurement & Construction Management for Frappe / ERPNext v16

License: MIT Documentation Frappe Version ERPNext Version


πŸ“¦ About EPCForge

EPCForge is an enterprise-grade Frappe application designed for Engineering, Procurement, and Construction (EPC) firms, main contractors, estimation engineers, and project managers. Built specifically for Frappe v16 and ERPNext v16, it extends ERPNext with hierarchical Bill of Quantities (BOQ), baseline budget tracking, vendor tender management, and an engineering document control register.

Whether managing multi-million-dollar infrastructure projects or commercial builds, EPCForge unifies cost estimation, tender bidding, document submittals, and financial tracking directly inside your ERPNext Desk.


✨ Detailed Features

🎯 BOQ (Bill of Quantities) Engine

  • Hierarchical Structure: Multi-level BOQ tree with parent/child sections and line items.
  • Automated Pricing: Quantity Γ— Unit Rate calculations with customizable profit margin percentages.
  • Milestone Payment Schedules: Link BOQ items to project billing milestones and percentage payouts.
  • Revision Audit History: Track changes across project stages with amended_from baseline history.

πŸ’Ύ Project Budgeting & Cost Control

  • Cost Head Allocation: Link BOQ sections directly to custom budget heads (Material, Labor, Equipment, Subcontractor).
  • Target vs. Actual Variance: Live calculation of committed amounts, actual expenditure from GL entries, and remaining balances.
  • Overrun Protection: Real-time variance warnings when Purchase Orders or Material Requests exceed target thresholds.

πŸ”Œ Tender & Bidder Management

  • Full Tender Lifecycle: Draft β†’ Open β†’ Under Evaluation β†’ Awarded β†’ Cancelled.
  • Flexible Classifications: Support for Open Tenders, Selective Bidding, Negotiated Tenders, and Single Source awards.
  • Bidder Invitations: Track invited suppliers, bid submission status, commercial scores, and evaluation notes.
  • Executive Reporting: Integrated Tender Summary report for contract pipeline insights.

⚑ Engineering Document Register

  • Centralized Control: Classify engineering assets into Drawings, Specifications, RFIs, Submittals, and NCRs.
  • Revision & Versioning: Strict revision tracking (Rev A, B, C...) to ensure teams work on current drawings.
  • Workflow Approval: Configurable review states (Draft β†’ Under Review β†’ Approved β†’ Issued).

πŸ“Š Reports & Dashboards

  • Tender Summary Report: Consolidated view of open, evaluated, and awarded tender packages.
  • BOQ Summary Report: Itemized breakdown of rates, margins, and section totals.
  • Budget vs. Actual Report: Variance report comparing planned allocations to financial actuals.
  • Desk Dashboards: Interactive charts and number cards for active project status and pending document reviews.

πŸ’» Prerequisites & Compatibility

  • Frappe Framework: v16.0.0 or higher (>=16.0.0,<17.0.0)
  • ERPNext: v16.0.0 or higher (>=16.0.0,<17.0.0)
  • Python: 3.10 or higher

βš™οΈ Installation

Install EPCForge on your Frappe bench using the Bench CLI:

# Navigate to your bench directory
cd ~/frappe-bench

# Fetch the repository
bench get-app https://github.com/invento-software-limited/epcforge

# Install on your target site
bench --site [your-site-name] install-app epcforge

# Build assets & run migrations
bench build
bench --site [your-site-name] migrate

πŸš€ Quick Start & Usage Workflow

  1. Set Up Project: Create or open a project in ERPNext standard Project master.
  2. Build BOQ: Click EPCForge β†’ New BOQ on the Project form. Add sections, line items, unit rates, and target margins, then Submit.
  3. Establish Budget: Select EPCForge β†’ Create Budget to allocate cost heads against the approved BOQ baseline.
  4. Float Tenders: Go to EPCForge β†’ Tenders to invite bidders, compare bids, and record awards.
  5. Register Documents: Go to EPCForge β†’ Document Register to upload drawings, assign revision numbers, and route for approval.

πŸ“š Documentation

Detailed documentation, user guide, and API reference are available on our GitHub Pages site: πŸ‘‰ EPCForge Online Documentation Portal


🏒 About Publisher & Support

Developed and maintained by Invento Software Limited. Invento builds enterprise-grade Frappe and ERPNext applications for construction, engineering, manufacturing, and supply chain enterprises.


πŸ“„ License

This repository is licensed under the MIT License.

About

EPCForge is a Frappe app that provides comprehensive Engineering, Procurement, and Construction (EPC) management for Frappe/ERPNext including BOQ, Budgeting, Tendering, and Document Control. πŸš€

Resources

Stars

7 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages