Requirements By Domain

Clean, domain-based organisation that aligns with system architecture and provides complete traceability to high-level functional requirements.

Structure Overview

requirements/
├── 00-system-administration/    # User management, configuration, setup
├── 01-access-control/           # Authentication, authorisation, sessions
├── 02-protection-management/    # PWA lifecycle, worksite protection
├── 03-worker-operations/        # Lock-on/off, roles, safety verification
├── 04-plant-operations/         # Plant lock-on/off, handover, tracking
├── 05-connectivity/             # Data synchronisation, offline capability, connection management
├── 06-reporting-analytics/      # Audit trails, compliance, dashboards
└── shared/                      # Common entities, glossary, standards

High-Level Requirements Traceability

This table maps our domain-specific requirements to the high-level functional requirements, ensuring complete coverage and clear traceability.

Functional Requirement	Domain	Specific Requirements
FR1.1-1.5: System Setup & Configuration	System Administration	User creation, project setup, worksite creation
FR2.1: User Authentication	Access Control	REQ-AUTH-001, REQ-AUTH-002
FR3.1-3.3: PWA Activation (Single Site)	Protection Management	REQ-PROT-001
FR4.1-4.5: PWA Activation (Multi Site)	Protection Management	REQ-PROT-002
FR5.1-5.4: Worker Lock-on	Worker Operations	REQ-WORK-001, REQ-WORK-002
FR6.1-6.2: Plant Lock-on	Plant Operations	REQ-PLANT-001, REQ-PLANT-002
FR7.1-7.3: Viewing Workers on Site	Worker Operations	REQ-WORK-003
FR8.1-8.5: Worker Lock-off	Worker Operations	REQ-WORK-006, REQ-WORK-007
FR9.1-9.2: Plant Lock-off	Plant Operations	REQ-PLANT-004
FR10.1: Plant Handover	Plant Operations	REQ-PLANT-003
FR11.1: Force Worker Lock-off	Worker Operations	REQ-WORK-007
FR12.1: Protection Handover	Protection Management	REQ-PROT-008

Domain Summaries

System Administration

User creation, project setup, worksite management, and initial system configuration. Provides the foundation data for all operational domains.

Access Control

User authentication, session management, role-based authorisation, and route protection. Merged domain covering both identity verification and permissions.

Protection Management

PWA lifecycle management, worksite protection activation, authorisation, and handover processes. Core protection functionality for single and multi-site scenarios.

Worker Operations

Worker sign-on, lock-on/off, role management, and safety verification. Complete worker operational lifecycle from arrival to departure.

Plant Operations

Plant lock-on/off, handover between operators, and operational tracking. Manages the active use phase of plant on worksites.

Connectivity

Data synchronisation, offline capability, connection management, and conflict resolution for both connected and disconnected operation scenarios.

Reporting & Analytics

Audit trails, compliance reporting, analytics dashboards, and business intelligence for operational oversight.

Content Organisation

Each domain contains:

• index.md - Domain overview, scope, and requirements index
• requirements/ - Detailed functional requirements using EARS format
• verification/ - Test specifications and verification matrices (where applicable)

Navigation Philosophy

Users navigate by operational domain rather than user role or specific process, enabling:

• Clear responsibility boundaries
• Better team organisation alignment
• Simplified requirement location and maintenance
• Improved traceability and impact analysis