Product Lifecycle Management — Overview & How to Use

Module: Product Lifecycle Management v1.0.0

What is Product Lifecycle Management?

Product lifecycle stages, tracking and governance for Perfex CRM

This module installs into modules/product_lifecycle_management/ and adds its own admin menus, permissions, and database tables — without editing Perfex CRM core files.

Who should use this module?

  • Admins — activate the module, configure Settings, assign roles, and manage integrations.
  • Operators / day-to-day staff — create and update records (orders, attendance, shipments, messages, etc.).
  • Managers / approvers — review queues, approve workflows, and monitor dashboards/KPIs.
  • Finance / compliance / ops leads — run reports, exports, and audit trails when the module supports them.

What you can achieve

  • Keep all related work in one place inside Perfex CRM instead of spreadsheets.
  • Control who can view, create, edit, approve, or export with role permissions.
  • Use dashboards and reports to see status, bottlenecks, and history.
  • Connect to other CRM data (customers, invoices, items, staff) where the module integrates.

Recommended learning path

  1. Read How to Install and activate the module.
  2. Skim Features so you know what screens exist.
  3. Complete the Quick Start checklist on this page (Settings → masters → first sample record).
  4. Open each screen guide under Screen-by-screen guides when you need step-by-step help.
  5. Check Version & Changelog after upgrades for new options.

Tip: Train one admin first, then create a limited role for operators so they only see the screens they need.

5-minute Quick Start

Follow this short path the first time you use Product Lifecycle Management:

  1. Activate — Setup → Modules → activate Product Lifecycle Management (run Upgrade if prompted).
  2. Permissions — Setup → Staff → Roles → enable view/create/edit (and approve/settings if needed) for this module.
  3. Settings — Open Product Lifecycle Management → Settings and save company defaults, prefixes, and integrations.
  4. Master data — Create the first required masters (products, warehouses, templates, channels, accounts, routes, etc.).
  5. First transaction — Create one sample record end-to-end (save → submit/approve → complete) and confirm it appears in lists/reports.
  6. Cron — If the module uses alerts, sync, queues, or AI, confirm Perfex CRM cron is scheduled on the server.

Full how-to guide (from module package)

The steps below come from the module author's printable guide — follow them in order for best results.

HOW TO USE — Product Lifecycle Management for Perfex CRM (v1.0.0)

Author: Nasbix Technologies

1) INSTALLATION

  1. Extract the purchased ZIP.

2. Upload the "product_lifecycle_management" folder to:

/modules/product_lifecycle_management

  1. Login to Perfex CRM Admin.

4. Go to: Setup → Modules

  1. Find "Product Lifecycle Management" and click Activate.

6. Database tables and options are created automatically

(plm_db_version = 100).

7. Assign permissions:

Setup → Staff → Roles / Permissions → PLM capabilities

2) FIRST-TIME SETUP

1. Open: PLM → Settings

2. Set:

- Product code prefix (e.g. PLM-)

- Document / ECO / ECN prefixes

- Require stage notes

- Default / Launch stage codes

- Enforce quality gates

- Auto-create CRM item on Launch

- Auto-discontinue on EOL

- Enable API / webhooks

  1. Save settings.
  2. Open PLM → Lifecycle Stages and review the seeded stages.
  3. Optionally open Quality Gates and confirm default gates.

3) DAILY WORKFLOW

A. Products

- PLM → Products → New Product

- Assign stage, owner, category, target launch date

- Link an existing CRM item (optional)

B. Stage transitions

- Open a product → Transition Stage

- Add notes (if required)

- Complete quality gate sign-off if enforcement is enabled

C. Engineering data

- Product → BOM / Specifications

- PLM → Documents (categories, revisions, uploads)

D. Change control

- PLM → Change Orders → New ECO/ECN

- Submit → Approve / Reject → Implement

E. Quality gates

- PLM → Quality Gates

- Checklist / sign-off / waive during transitions

F. Reports & integrations

- PLM → Reports (CSV export)

- Settings → API Keys / Webhooks

4) UNINSTALL (CLEAN REMOVAL)

1. Setup → Modules → Deactivate Product Lifecycle Management

2. Click Uninstall

3. Module removes all plm_* tables, options, and uploads/plm/

  1. No Perfex CRM core files are modified.

5) SUPPORT

  • Open documentation/index.html
  • Include Perfex version, PHP version, and plm_db_version
  • Author: Nasbix Technologies

Module documentation index

Start here — full guides for Product Lifecycle Management:

Screen-by-screen guides (each tab explained)

Click a menu item below for step-by-step instructions on that Product Lifecycle Management screen:

How to use in Perfex CRM (daily operations)

  1. Sign in to the admin area with a role that includes Product Lifecycle Management permissions.
  2. Open Product Lifecycle Management (sidebar) or search for Product Lifecycle Management in the admin menu.
  3. Start on the Dashboard (if available) to see open tasks, pending approvals, and KPIs.
  4. Review Settings after upgrades — new options may need defaults for your company.
  5. Create or import master data first; most modules block transactions until masters exist.
  6. Run the main business flow (create → submit → approve → post/complete) using the screens listed in Admin menu below.
  7. Use Reports / Analytics screens to reconcile stock, finance, compliance, or SLA metrics.
  8. For integrations (API, EDI, gateways, tax), confirm credentials in Settings and monitor logs or webhook delivery screens.
  9. Train staff with role-based access — give approvers approve permissions only, operators create/edit on their area.
  10. If something fails overnight, check Perfex CRM cron ran and open the module log / failed queue screen if present.

Admin menu — where to work

Open the Product Lifecycle Management section in the admin sidebar. Screens your staff may use (depending on role):

  • Bill of Materials
  • Change Orders
  • Document Categories
  • Documents
  • Lifecycle Stages
  • PLM
  • PLM Dashboard
  • Products
  • Quality Gates
  • Reports
  • Settings
  • Specifications

Screens map — what each menu is for

These are the admin screens registered by Product Lifecycle Management. Click a name in the Knowledge Base for a full how-to, or open the path in admin.

#ScreenAdmin pathGuide
1PLM Dashboardadmin/product_lifecycle_managementHow to use
2Productsadmin/product_lifecycle_management/product_lifecycle_management_productsHow to use
3Lifecycle Stagesadmin/product_lifecycle_management/product_lifecycle_management_stagesHow to use
4Documentsadmin/product_lifecycle_management/product_lifecycle_management_documentsHow to use
5Document Categoriesadmin/product_lifecycle_management/product_lifecycle_management_document_categoriesHow to use
6Change Ordersadmin/product_lifecycle_management/product_lifecycle_management_change_ordersHow to use
7Quality Gatesadmin/product_lifecycle_management/product_lifecycle_management_quality_gatesHow to use
8Reportsadmin/product_lifecycle_management/product_lifecycle_management_reportsHow to use
9Settingsadmin/product_lifecycle_management/product_lifecycle_management_settingsHow to use

Detailed guide — features, workflows, API & FAQ

Features

AreaDescription
-------------------
LifecycleStages, products, transitions, dashboard
EngineeringBOM, specifications, product documents
Change controlECO/ECN with approval and implementation
QualityStage-gate checklists and sign-offs
IntegrationsREST API, webhooks, CSV reports

Permissions

FeatureCapabilities
-----------------------
plm_dashboardview
plm_productsview, create, edit, delete, transition
plm_stagesview, create, edit, delete
plm_bomview, create, edit, delete
plm_specificationsview, create, edit, delete
plm_documentsview, create, edit, delete
plm_document_categoriesview, create, edit, delete
plm_change_ordersview, create, edit, delete, approve, implement
plm_quality_gatesview, create, edit, delete, signoff, waive
plm_reportsview, export
plm_settingsview, edit

REST API

Base URL: {site_url}/product_lifecycle_management/plm_api

Auth: Header X-PLM-API-Key: {token} or Authorization: Bearer {token}

Manage keys: PLM → Settings → API Keys

How To Use

  1. Review seeded Lifecycle Stages (or create your own pipeline).
  2. Create a Product, assign an owner/stage, and optionally link a CRM item.
  3. Add BOM lines, Specifications, and Documents for the product revision.
  4. Use Quality Gates before stage transitions when enforcement is enabled.
  5. Move the product through stages and keep transition notes for audit.
  6. Create ECO/ECN Change Orders for controlled engineering changes (submit → approve → implement).
  7. Export Reports (CSV) and optionally enable API Keys / Webhooks.

A printable guide is also included as HOW_TO_USE.txt.

Features

  • Lifecycle stages, products, transitions, and dashboard widget
  • BOM, specifications, and document control with revisions
  • Engineering Change Orders (ECO/ECN) with approval workflow
  • Quality gates with checklists, sign-off, and waive
  • CSV reports, REST API, and outbound webhooks
  • Clean uninstall removes tables, options, and uploads/plm/

Permissions

Assign capabilities under Setup → Staff → Roles.

FeatureCapabilities
plm_dashboardview
plm_productsview, create, edit, delete, transition
plm_stagesview, create, edit, delete
plm_bom / plm_specificationsview, create, edit, delete
plm_documents / categoriesview, create, edit, delete
plm_change_ordersview, create, edit, delete, approve, implement
plm_quality_gatesview, create, edit, delete, signoff, waive
plm_reportsview, export
plm_settingsview, edit

Uninstall

  1. Deactivate Product Lifecycle Management in Setup → Modules.
  2. Click Uninstall.

This removes all PLM database tables, module settings, and uploaded files under uploads/plm/. Core Perfex CRM files are not modified.

After activation — configuration checklist

  1. Go to Setup → Modules and activate Product Lifecycle Management.
  2. Reload admin once if menus do not appear — schema version plm_db_version is set to 100 for v1.0.0.
  3. Assign permissions under Setup → Staff → Roles.
  4. Open PLM → Settings and configure prefixes, gates, API, and webhooks.
  5. Perfex CRM 2.3+ (3.x recommended)
  6. PHP 7.4+ (8.1+ recommended)
  7. MySQL 5.7+ / MariaDB 10.3+ (InnoDB)
  8. PHP extensions: mysqli, json, mbstring, curl, fileinfo

Staff permissions (from module)

Assign under Setup → Staff → Roles. Each feature can expose different actions:

FeatureActions
PLM Dashboard
plm_dashboard
view
Products
plm_products
view, create, edit, delete, transition
Lifecycle Stages
plm_stages
view, create, edit, delete
Reports
plm_reports
view, export
Settings
plm_settings
view, edit
Bill of Materials
plm_bom
view, create, edit, delete
Specifications
plm_specifications
view, create, edit, delete
Documents
plm_documents
view, create, edit, delete
Document Categories
plm_document_categories
view, create, edit, delete
Change Orders
plm_change_orders
view, create, edit, delete, approve, implement
Quality Gates
plm_quality_gates
view, create, edit, delete, signoff, waive

One-time setup (first time only)

  1. Setup → Modules → activate Product Lifecycle Management.
  2. Setup → Staff → Roles → assign Product Lifecycle Management permissions (view, create, edit, delete, approve, export, settings as needed).
  3. Open Product Lifecycle Management → Settings and complete company defaults, prefixes, integrations, and notification options.
  4. Create master data (warehouses, products, templates, accounts, routes, etc.) before processing live transactions.
  5. Enable Perfex CRM cron (php /path/to/perfex/index.php cron/index) for sync, retries, alerts, and scheduled jobs.
  6. Optionally enable REST API / webhooks in module settings if you integrate external systems.

Tips for success

  • Always configure Settings before creating live transactions.
  • Create master data (items, warehouses, templates, channels, accounts) first — most modules block incomplete records.
  • Use a test/sample record before going live with real customers or production stock.
  • Separate roles: operators create/edit; managers approve; finance/reporting get view/export only.
  • After any module upgrade, reopen Settings and confirm new options have sensible defaults.
  • If overnight jobs fail, verify Perfex CRM cron and check the module log / failed queue screen.

Common questions (FAQ)

Where do I find the module after activation?

In the admin sidebar look for Product Lifecycle Management. If missing, your role may lack view permission — fix under Setup → Staff → Roles.

Do I need to edit core Perfex CRM files?

No. Keep all custom code under modules/product_lifecycle_management/. Activate/deactivate from Setup → Modules.

What happens if I uninstall?

Deactivate keeps data. Uninstall usually removes module tables/options (see the Install article). Core customers, invoices, and items are not deleted by well-built modules.

Why can't my staff see a screen?

Almost always a permissions issue. Give the role at least view on that feature, then ask the user to log out and back in.

Reports/export buttons do nothing

Confirm the role has export (or view reports) permission, and that filters return at least one row. Try PDF/CSV from a wider date range.

FAQ from module documentation

Support

See documentation/index.html for the buyer guide.


Perfex CRM Knowledge Base — detailed usage guide generated from module README, HOW_TO_USE, and documentation.

Did you find this article useful?