Module: Product Lifecycle Management v1.4.0
Product lifecycle stages, tracking and governance for BIXCRM
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 BIXCRM (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 BIXCRM 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
Detailed guide — features, workflows, API & FAQ
Features Summary
| Phase | Scope | Status |
|---|---|---|
| ------- | ------- | -------- |
| Phase 1 | Lifecycle stages, products, transitions, dashboard | Done |
| Phase 2 | BOM, specifications, product documents | Done |
| Phase 3 | Engineering Change Orders (ECO/ECN) | Done |
| Phase 4 | Quality gates, stage-gate approvals | Done |
| Phase 5 | REST API, webhooks, reports, enterprise integration | Done |
Phase 5 Features
| Feature | Status |
|---|---|
| --------- | -------- |
| REST API (products, stages, change orders, quality gates) | Done |
| API key management with scopes (read / write / read_write) | Done |
| Webhooks (product.launched, product.eol, change.approved, gate.completed) | Done |
| CSV export reports (portfolio, pipeline, change orders, transitions) | Done |
| Manufacturing BOM sync on Launch | Done |
| Auto-discontinue on EOL | Done |
| Demand Planning launch date feed | Done |
| Integration audit log | Done |
REST API
Base URL: {site_url}/product_lifecycle_management/plm_api
Auth: Header X-PLM-API-Key: {token} or Authorization: Bearer {token}
| Endpoint | Description |
|---|---|
| ---------- | ------------- |
GET /plm_api | API info & endpoint list |
GET /plm_api/products | List products |
GET /plm_api/products/{id} | Product detail |
GET /plm_api/products/{id}/transitions | Stage transition history |
GET /plm_api/stages | Lifecycle stages |
GET /plm_api/change_orders | Change orders |
GET /plm_api/quality_gates | Quality gate definitions |
Manage keys: PLM → Settings → API Keys
Webhooks
| Event | Trigger |
|---|---|
| ------- | --------- |
product.launched | Product transitions to Launch stage |
product.eol | Product transitions to EOL stage |
product.transition | Any stage transition |
change.approved | Change order approved |
gate.completed | Quality gate signed off |
Manage webhooks: PLM → Settings → Webhooks
Reports
PLM → Reports — Product Portfolio, Lifecycle Pipeline, Change Orders Summary, Stage Transitions (CSV export)
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 |
Database Tables
| Table | Purpose |
|---|---|
| ------- | --------- |
plm_lifecycle_stages | Lifecycle stage master |
plm_products | Product records |
plm_stage_transitions | Stage change history |
plm_bom_lines | Bill of materials per revision |
plm_specifications | Technical specs per revision |
plm_documents / plm_document_revisions | Product documents |
plm_change_orders / plm_change_order_impacts | ECO/ECN workflow |
plm_quality_gates / plm_gate_checklist_items / plm_product_gate_signoffs | Stage-gate process |
plm_api_keys | REST API authentication |
plm_webhooks / plm_webhook_deliveries | Outbound webhook config & log |
plm_integration_logs | Cross-module integration audit |
plm_logs | General audit trail |
Hooks
hooks()->add_action('plm_change_order_approved', function ($change_order) { ... });
hooks()->add_action('plm_change_order_implemented', function ($change_order) { ... });
hooks()->add_action('plm_quality_gate_completed', function ($signoff) { ... });
hooks()->add_action('plm_product_stage_transition', function ($product, $from, $to) { ... });
hooks()->add_action('plm_demand_planning_launch_feed', function ($payload) { ... });
hooks()->add_action('plm_manufacturing_bom_synced', function ($product, $bom_id) { ... });
hooks()->add_action('plm_discontinue_item', function ($product) { ... });
hooks()->add_action('plm_webhook_dispatched', function ($event, $payload) { ... });
DB Version
Check option plm_db_version — expected 104.
Features
Product lifecycle stages, tracking and governance for BIXCRM
See README.md in the module folder for the complete feature list.
Permissions
Granular staff capabilities are registered on activation. Assign them under Setup → Staff → Roles for the Product Lifecycle Management capability group.
Typical capabilities include view, create, edit, delete, plus module-specific actions (approve, export, settings, API access).
Cron Jobs
Background tasks (if enabled) run through BIXCRM's main cron. Example crontab (every 5 minutes):
* * * * * php /path/to/bixcrm/index.php cron/index > /dev/null 2>&1
Check module settings for scheduled jobs (alerts, sync, reports, retention).
After activation — configuration checklist
- Go to Setup → Modules and activate Product Lifecycle Management.
- If prompted, click Upgrade Database or reload admin — migrations run automatically.
- Assign permissions under Setup → Staff → Roles.
- Open the module menu and configure settings.
- BIXCRM 3.0+
- 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 BIXCRM cron (
php /path/to/bixcrm/index.php cron/index) for sync, retries, alerts, and scheduled jobs. - Optionally enable REST API / webhooks in module settings if you integrate external systems.
BIXCRM Knowledge Base — usage guide generated from module README and documentation.