RAMS Document Builder

RAMS Document Builder

The RAMS Document Builder uses a five-step stepper wizard to guide you through creating a complete Risk Assessment Method Statement. The builder is presented as a compact right-panel sidebar with collapsible expansion panels, and includes auto-save functionality so your work is never lost.

Step 1: Document Information

The first step captures the core metadata for your RAMS document:

• Project Selection — link the document to an existing project from your project list
• Activity Name — a descriptive title for the work activity being assessed
• Document Type — select either RAMS (standard risk assessment method statement) or Pre-Construction Information (CDM requirement)
• Reviewer Assignment — designate a team member responsible for reviewing the document
• Approver Assignment — designate the person with authority to formally approve the document

Step 2: Hazards & Risk Assessment

The hazard identification step is the core of the RAMS document. You can add hazards from three sources:

• Add from Library — browse and select from the pre-seeded hazard library of 100+ hazards
• Add Custom — create a bespoke hazard specific to your activity
• Smart Suggestions — AI-assisted hazard recommendations based on your project type and equipment manifest

Each hazard displays the following in a compact card format:

• Risk Score Avatar — circular indicator showing the calculated score (Likelihood × Severity)
• Risk Level Chip — colour-coded label showing Low, Medium, High, or Critical
• Expandable Editor — click to expand and access the full hazard editing interface

Within the expanded editor, you can adjust:

• Initial Risk Matrix Sliders — set Likelihood and Severity before control measures
• Control Measures List — add, edit, and reorder control measures following the hierarchy of controls
• Residual Risk Matrix Sliders — set Likelihood and Severity after control measures are applied

Step 3: Method Statement

The method statement section provides a step-by-step work method builder. Each step is an ordered entry with a sequence number and detailed description of the work to be carried out. Steps can be reordered using drag-and-drop, and new steps are inserted at any position in the sequence.

Step 4: Emergency Procedures

This step captures the emergency response arrangements for the activity:

• Emergency Response — general emergency arrangements and communication protocols
• First Aid — first aid provisions, personnel, and equipment locations
• Fire Procedures — fire prevention measures and evacuation routes
• Evacuation Plan — assembly points, roll call procedures, and emergency contacts

Step 5: Review & Submit

The final step presents a complete read-only summary of the document for review. All sections are displayed in a print-friendly format. A Submit for Review button transitions the document from draft to under_review status, notifying the assigned reviewer.

PPE Requirements

A dedicated section displays a checklist of all required personal protective equipment items aggregated from the control measures across all hazards. This provides a single reference for PPE requirements for the entire activity.

Signatures

The signatures section collects and displays digital signatures from the document author, reviewer, approver, and briefed crew members. Each signature records the signatory name, role, timestamp, and a captured digital signature.

Additional Features

• Auto-Save — an indicator in the toolbar shows save status; changes are persisted automatically
• Save Draft — manually save the current state at any time
• Preview (PDF) — generate a formatted PDF preview of the document
• Smart Create Dialog — AI-assisted RAMS creation that pre-populates hazards and controls from project data

All document data is stored as JSONB in the document_data column, providing flexible schema evolution whilst maintaining queryability through PostgreSQL JSON operators.