Decision: Vehicle/Plant QR Code Integration β
Quick Summary β
Should Vehicle, Mobile Plant, and Hi-Rail Vehicle qualifications be included in QR codes or handled solely through manual plant lock-on processes?
Context β
The system handles different types of lock-on scenarios, with varying complexity and safety requirements across individual workers and vehicle/plant operations.
Current State:
- Individual workers can have QR codes for rapid lock-on
- Manual plant lock-on process exists for vehicle/plant operations
- Vehicle (V), Mobile Plant (MP), and Hi-Rail Vehicle (HRV) qualifications exist
- No current integration between QR codes and vehicle/plant qualifications
- Separate workflows for individual worker vs plant lock-on
Business Context:
- Workers often possess both individual competencies and vehicle/plant qualifications
- Plant operations have additional safety considerations beyond individual competency
- Manual plant lock-on provides oversight and verification for high-risk activities
- Operational efficiency important for multi-qualified personnel
- Data entry overhead for qualified operators can be significant
Technical Context:
- QR codes have payload size limitations
- Manual plant lock-on requires form completion and verification
- Integration between QR system and manual processes needs design
- Different verification workflows appropriate for different entity types
Decision Required β
How should vehicle/plant qualifications be handled in relation to QR codes and manual plant lock-on processes?
Success Criteria β
What does a good decision look like?
- [ ] Reduces data entry overhead for multi-qualified personnel
- [ ] Maintains appropriate safety oversight for plant operations
- [ ] Provides complete qualification picture for supervisors/protectors
- [ ] Supports efficient lock-on for qualified operators
- [ ] Preserves manual verification for plant-specific safety checks
- [ ] Creates clear, understandable workflow for field operations
- [ ] Balances efficiency with safety oversight requirements
Options β
Option 1: Include Vehicle/Plant in QR with Manual Process Integration β
Description: Include vehicle/plant qualifications in QR codes but route to manual plant lock-on process with pre-populated data from QR.
Analysis
Pros:
- Provides complete qualification picture in single QR scan
- Reduces data entry overhead through pre-population
- Maintains manual verification for plant-specific safety considerations
- Combines efficiency of QR data with oversight of manual process
- Supports comprehensive competency record in QR codes
- Enables efficient workflow for multi-qualified personnel
Cons:
- Increases QR code size and complexity with vehicle/plant data
- Creates hybrid workflow that may confuse field operations
- Implementation complexity for QR/manual process integration
- Potential for QR data to become out of sync with current qualifications
Risks:
- QR payload size becomes too large for reliable scanning - Mitigation: Optimise data encoding and test QR size limits
- Hybrid workflow creates user confusion - Mitigation: Clear UI design and training
- Pre-populated data creates false confidence - Mitigation: Require manual verification of all pre-populated fields
Implementation Effort: 4-5 weeks (QR generation updates, manual process integration, pre-population logic) Maintenance Overhead: Medium (QR/manual process synchronisation)
Option 2: Exclude Vehicle/Plant from QR Codes β
Description: Keep QR codes for individual worker competencies only, handle all vehicle/plant qualifications through manual process exclusively.
Analysis
Pros:
- Simple separation of individual vs plant qualification workflows
- Keeps QR codes focused and smaller
- Clear distinction between autonomous and supervised processes
- No integration complexity between QR and manual systems
- Manual process provides full oversight for all plant operations
Cons:
- Requires duplicate data entry for multi-qualified personnel
- Eliminates efficiency benefits for plant-qualified workers
- No visibility of plant qualifications during individual worker assessment
- Potential for data entry errors during manual qualification entry
- Reduced value proposition of QR system for multi-qualified workers
Risks:
- Significant efficiency loss for qualified operators - Mitigation: Streamlined manual entry forms
- Data entry errors increase with manual qualification entry - Mitigation: Validation and verification processes
- User frustration with duplicate data entry - Mitigation: Training and process improvement
Implementation Effort: 1 week (ensure QR system excludes plant data) Maintenance Overhead: Low (separate systems, no integration)
Option 3: Full QR Autonomy for Vehicle/Plant β
Description: Allow QR codes to enable full autonomous lock-on for vehicle/plant operations without manual verification.
Analysis
Pros:
- Maximum efficiency for QR users with plant qualifications
- Consistent autonomous process for all QR-enabled operations
- Simple implementation leveraging existing QR system
- No manual process dependency for qualified operators
- Fastest lock-on process for plant operations
Cons:
- Eliminates safety oversight for high-risk plant operations
- Reduces situational assessment opportunity for plant-specific hazards
- May not meet safety requirements for vehicle/plant supervision
- No manual verification of plant-specific conditions
- Potential regulatory compliance issues
Risks:
- Safety incidents due to inadequate plant operation oversight - Mitigation: Enhanced QR qualification validation, but eliminates real-time assessment
- Regulatory non-compliance with plant supervision requirements - Mitigation: Documentation, but may not meet regulatory intent
- Plant-specific hazards not assessed - Mitigation: Pre-shift briefings, but reduces point-of-use verification
Implementation Effort: 2-3 weeks (QR generation for plant qualifications, autonomous plant lock-on) Maintenance Overhead: Low (extended QR system)
Constraints & Requirements β
Must Have β
- Appropriate safety oversight for plant operations
- Support for multi-qualified personnel efficiency
- Clear workflow understanding for field operations
- Integration with existing competency and manual systems
- Audit trail for plant lock-on verification
Should Have β
- Reduced data entry overhead for qualified operators
- Reasonable implementation and maintenance complexity
- Flexibility for different plant operation scenarios
- Clear responsibility model for plant lock-on verification
Must Not β
- Eliminate necessary safety verification for plant operations
- Create unmanageable complexity in QR/manual process integration
- Block plant operations due to technical system failures
- Create significant user experience degradation
Research & Evidence β
Completed Research β
- [x] Multi-qualified personnel analysis - Result: Common for workers to have both individual and plant qualifications
- [x] Manual plant process requirements - Result: Additional verification beyond individual competency needed
- [x] QR payload capacity - Result: Additional data possible but size considerations important
- [x] Plant operation safety requirements - Result: Higher risk operations requiring additional oversight
Outstanding Research β
- [ ] QR payload size testing with vehicle/plant data
- [ ] Field operations preferences for plant lock-on workflow
- [ ] Technical complexity assessment for QR/manual integration
- [ ] Safety requirements for vehicle/plant operation supervision
Evidence & Data β
- Multi-qualified personnel represent significant portion of workforce
- Plant operations have additional safety considerations beyond individual competency
- Manual data entry creates efficiency bottlenecks for qualified operators
- Plant lock-on requires oversight for situational assessment
Stakeholders & RACI β
| Role | Person/Team | Responsible | Accountable | Consulted | Informed |
|---|---|---|---|---|---|
| Decision Maker | Product Owner | β | |||
| Technical Lead | Development Team | β | |||
| Safety Manager | Safety Team | β | |||
| Field Operations | RPOs & Site Protectors | β | |||
| Plant Operations | Vehicle/Plant Operators | β | |||
| Implementation Team | Development Team | β |
Impact Assessment β
Blocked Items β
- QR code generation for plant qualifications awaits integration decision
- Manual plant lock-on UI enhancements depend on integration approach
- Multi-qualified personnel workflow design requires process clarity
Affected Components β
- QR Code Generation Service - Impact: Plant qualification data inclusion (Option 1,3)
- Manual Plant Lock-On UI - Impact: Pre-population integration (Option 1)
- QR Code Scanner - Impact: Plant qualification parsing and routing
- Plant Qualification Service - Impact: Integration with QR system for data synchronisation
- Audit System - Impact: Plant lock-on audit trail for chosen workflow
Timeline Impact β
- If decided by deadline: Can proceed with plant qualification workflow implementation
- If delayed by 1 week: Minor impact on QR generation and manual process development
- If delayed by 1 month: Blocks multi-qualified personnel features and plant operation enhancements
Decision Log β
| Date | Update | Author |
|---|---|---|
| 2025-09-09 | Decision created based on vehicle/plant QR integration questions | Simon + Claude |
Next Actions β
Immediate (Next 3 Days) β
- [ ] Test QR payload capacity with vehicle/plant qualification data
- [ ] Review plant operation safety requirements with Safety Team
- [ ] Assess field operations preferences for plant lock-on workflow
Short Term (Next 2 Weeks) β
- [ ] Evaluate technical complexity for QR/manual process integration
- [ ] Consult with Plant Operations on workflow preferences
- [ ] Assess implementation effort for different integration options
- [ ] Make final decision
Decision Meeting β
- Scheduled: [To be scheduled]
- Attendees: Product Owner, Technical Lead, Safety Manager, Field Operations Representative, Plant Operations Representative
- Agenda: Review integration options, assess technical and safety requirements, make decision
References & Links β
Requirements β
- [To be linked]: Vehicle/Plant operator qualification requirements
- [To be linked]: Manual plant lock-on process requirements
- [To be linked]: QR code payload requirements
Specifications β
- [To be linked]: QR code generation specification
- [To be linked]: Manual plant lock-on UI specification
- [To be linked]: Vehicle/Plant qualification specification
Related Decisions β
- ADR-010: QR Code Security and Trust Model (affects vehicle/plant data security in QR codes)
- ADR-013: DS Worker Lock-On Process (manual processes for different worker types)
Decision Outcome β
To be filled when decision is made
Final Decision: [Decision made]
Rationale: [Why this decision was made]
Decision Date: [Date]