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
- Read How to Install and activate the module.
- Skim Features so you know what screens exist.
- Complete the Quick Start checklist on this page (Settings → masters → first sample record).
- Open each screen guide under Screen-by-screen guides when you need step-by-step help.
- 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:
- Activate — Setup → Modules → activate Product Lifecycle Management (run Upgrade if prompted).
- Permissions — Setup → Staff → Roles → enable view/create/edit (and approve/settings if needed) for this module.
- Settings — Open Product Lifecycle Management → Settings and save company defaults, prefixes, and integrations.
- Master data — Create the first required masters (products, warehouses, templates, channels, accounts, routes, etc.).
- First transaction — Create one sample record end-to-end (save → submit/approve → complete) and confirm it appears in lists/reports.
- 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
- Extract the purchased ZIP.
2. Upload the "product_lifecycle_management" folder to:
/modules/product_lifecycle_management
- Login to Perfex CRM Admin.
4. Go to: Setup → Modules
- 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
- Save settings.
- Open PLM → Lifecycle Stages and review the seeded stages.
- 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/
- 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:
- Overview & How to Use — what it is, who uses it, daily workflow
- Quick Start Guide — first 5 minutes + printable how-to
- How to Install — upload, activate, permissions, verify
- Features (Full Detail) — every capability explained
- FAQ & Tips — common questions and best practices
- Version & Changelog — version history
Screen-by-screen guides (each tab explained)
Click a menu item below for step-by-step instructions on that Product Lifecycle Management screen:
- PLM Dashboard
- Products
- Lifecycle Stages
- Documents
- Document Categories
- Change Orders
- Quality Gates
- Reports
- Settings
How to use in Perfex CRM (daily operations)
- Sign in to the admin area with a role that includes Product Lifecycle Management permissions.
- Open Product Lifecycle Management (sidebar) or search for Product Lifecycle Management in the admin menu.
- Start on the Dashboard (if available) to see open tasks, pending approvals, and KPIs.
- Review Settings after upgrades — new options may need defaults for your company.
- Create or import master data first; most modules block transactions until masters exist.
- Run the main business flow (create → submit → approve → post/complete) using the screens listed in Admin menu below.
- Use Reports / Analytics screens to reconcile stock, finance, compliance, or SLA metrics.
- For integrations (API, EDI, gateways, tax), confirm credentials in Settings and monitor logs or webhook delivery screens.
- Train staff with role-based access — give approvers approve permissions only, operators create/edit on their area.
- 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.
| # | Screen | Admin path | Guide |
|---|---|---|---|
| 1 | PLM Dashboard | admin/product_lifecycle_management | How to use |
| 2 | Products | admin/product_lifecycle_management/product_lifecycle_management_products | How to use |
| 3 | Lifecycle Stages | admin/product_lifecycle_management/product_lifecycle_management_stages | How to use |
| 4 | Documents | admin/product_lifecycle_management/product_lifecycle_management_documents | How to use |
| 5 | Document Categories | admin/product_lifecycle_management/product_lifecycle_management_document_categories | How to use |
| 6 | Change Orders | admin/product_lifecycle_management/product_lifecycle_management_change_orders | How to use |
| 7 | Quality Gates | admin/product_lifecycle_management/product_lifecycle_management_quality_gates | How to use |
| 8 | Reports | admin/product_lifecycle_management/product_lifecycle_management_reports | How to use |
| 9 | Settings | admin/product_lifecycle_management/product_lifecycle_management_settings | How to use |
Detailed guide — features, workflows, API & FAQ
Features
| Area | Description |
|---|---|
| ------ | ------------- |
| Lifecycle | Stages, products, transitions, dashboard |
| Engineering | BOM, specifications, product documents |
| Change control | ECO/ECN with approval and implementation |
| Quality | Stage-gate checklists and sign-offs |
| Integrations | REST API, webhooks, CSV reports |
Permissions
| Feature | Capabilities |
|---|---|
| --------- | -------------- |
plm_dashboard | view |
plm_products | view, create, edit, delete, transition |
plm_stages | view, create, edit, delete |
plm_bom | view, create, edit, delete |
plm_specifications | view, create, edit, delete |
plm_documents | view, create, edit, delete |
plm_document_categories | view, create, edit, delete |
plm_change_orders | view, create, edit, delete, approve, implement |
plm_quality_gates | view, create, edit, delete, signoff, waive |
plm_reports | view, export |
plm_settings | view, 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
- Review seeded Lifecycle Stages (or create your own pipeline).
- Create a Product, assign an owner/stage, and optionally link a CRM item.
- Add BOM lines, Specifications, and Documents for the product revision.
- Use Quality Gates before stage transitions when enforcement is enabled.
- Move the product through stages and keep transition notes for audit.
- Create ECO/ECN Change Orders for controlled engineering changes (submit → approve → implement).
- 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.
| Feature | Capabilities |
|---|---|
| plm_dashboard | view |
| plm_products | view, create, edit, delete, transition |
| plm_stages | view, create, edit, delete |
| plm_bom / plm_specifications | view, create, edit, delete |
| plm_documents / categories | view, create, edit, delete |
| plm_change_orders | view, create, edit, delete, approve, implement |
| plm_quality_gates | view, create, edit, delete, signoff, waive |
| plm_reports | view, export |
| plm_settings | view, edit |
Uninstall
- Deactivate Product Lifecycle Management in Setup → Modules.
- 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
- Go to Setup → Modules and activate Product Lifecycle Management.
- Reload admin once if menus do not appear — schema version plm_db_version is set to 100 for v1.0.0.
- Assign permissions under Setup → Staff → Roles.
- Open PLM → Settings and configure prefixes, gates, API, and webhooks.
- Perfex CRM 2.3+ (3.x recommended)
- PHP 7.4+ (8.1+ recommended)
- MySQL 5.7+ / MariaDB 10.3+ (InnoDB)
- PHP extensions: mysqli, json, mbstring, curl, fileinfo
One-time setup (first time only)
- Setup → Modules → activate Product Lifecycle Management.
- Setup → Staff → Roles → assign Product Lifecycle Management permissions (view, create, edit, delete, approve, export, settings as needed).
- Open Product Lifecycle Management → Settings and complete company defaults, prefixes, integrations, and notification options.
- Create master data (warehouses, products, templates, accounts, routes, etc.) before processing live transactions.
- Enable Perfex CRM cron (
php /path/to/perfex/index.php cron/index) for sync, retries, alerts, and scheduled jobs. - 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.