Welcome to CURISTICA Hazard Log Visualiser
A cloud-based platform for managing medical device hazard logs in compliance with DCB0129, DCB0160, and ISO 14971.
đ Complete User Manual Available!
For detailed step-by-step instructions, workflows, and troubleshooting, see: USER_GUIDE.md
The guide covers everything from importing data to exporting regulatory reports.
đ Quick Start
First Time Users:
- Select a product from the dropdown in the header above
- Explore the tabs below to view your hazard log in different formats
- Import new data via the Import tab (Excel â Database)
đ¤ Need to import your hazard log?
Go to the Import tab â Select Excel file â Normalize â Convert â Upload to Database
đ Platform Tabs
2ī¸âŖ Hazard Log
Your main workspace âĸ View, Edit, Export âĸ Database persistence
What is this tab for?
View: Hierarchical display with search, statistics, and pagination
Edit: Click âī¸ EDIT MODE in the floating sidebar to add/modify/delete items
Save: Click đž Save Changes to write to database (all users see changes)
Export: Download JSON or Excel (Data format for analysis, Report format for presentations)
Protection: Auto-save every 30 seconds âĸ Undo/Redo (Ctrl+Z/Y) âĸ Warning on page close
3ī¸âŖ Bow-Tie Diagram
Simple visual: Causes â Controls â Hazard â Harm âĸ Best for presentations
4ī¸âŖ Network Graph (D3.js)
Interactive bow-tie with zoom/pan âĸ Risk color-coding (1-5 scale)
5ī¸âŖ Network Graph (Cytoscape.js) â
Advanced graph âĸ Shared control detection (orange border) âĸ Click controls to highlight
What makes this special?
Shared Control Detection: Automatically identifies controls that mitigate multiple causes (shown with orange border and count)
Interactive Highlighting: Click any control to see its relationships with golden highlights
Split Layout: Graph view (left) + Detail panel (right) for exploring complex relationships
Best For: Finding shared controls and understanding control-to-cause mappings
6ī¸âŖ Import
Convert Excel to database âĸ Normalize â Convert â Upload
7ī¸âŖ Settings
Database management âĸ View products âĸ Delete (requires typing "DELETE")
â Common Workflows
Adding New Hazards/Controls
- Go to Hazard Log tab
- Click âī¸ EDIT MODE in the floating sidebar (right side)
- Click â Add buttons to add new items
- Click đž Save Changes to write to database
- Switch tabs to see changes visualized
Editing Existing Items
- Enter edit mode (âī¸ EDIT MODE button)
- Click any field with blue dashed border to edit
- Type changes and click away to save to memory
- Use Ctrl+Z to undo, Ctrl+Y to redo
- Click đž Save Changes when ready
Importing New Product
- Go to Import tab
- Select Excel file (.xlsx)
- Click Normalize â Convert to JSON
- Fill in product metadata (name, version, DCB)
- Click Upload to Database
- Product appears in header dropdown immediately
Exporting Reports
- Go to Hazard Log tab
- Click đ Export Excel (Report) for NHS Standard format
- Or click đ Export Excel (Data) for flat analysis format
- File downloads with 4 tabs: Summary, Hazard Log, Risk Matrix, Controls
- Use Report format for regulatory submissions (DCB0129/DCB0160)
â ī¸ Deleting a Product (PERMANENT)
- Go to Settings tab â Click đ Refresh
- Find product in table, click đī¸ Delete
- Read warning carefully
- Type exactly DELETE (all caps) in the input field
- Press Enter or click Delete Project button
â ī¸ WARNING: Permanently deletes ALL hazards, causes, controls, evidence, and relationships. Cannot be undone! Export JSON backup first.
đĄ Key Features to Remember
- âī¸ Database Sync: Edits persist across sessions and are visible to all users instantly
- đī¸ Live Preview: See edits in all tabs before clicking Save Changes
- âļ Undo/Redo: Full change history with Ctrl+Z (undo) and Ctrl+Y (redo)
- đž Auto-Save: Browser backup every 30 seconds (not database - click đž Save for that)
- đ¨ Risk Color Coding: 1 Green 2 Yellow 3 Orange 4 Light Red 5 Dark Red
- đ Shared Controls: Orange border in Cytoscape graph = control protects multiple causes
đ Need More Help?
For detailed instructions, see USER_GUIDE.md
- Step-by-step workflows
- Troubleshooting guide
- NHS Risk Matrix explanation
- Compliance requirements (DCB0129, DCB0160, ISO 14971)
- Best practices and tips
⨠Ready to Start?
Select a product from the dropdown above or click the Import tab to upload your hazard log.
đĨ Import JSON to Database
Upload a processed JSON file (v2.0 normalized format) to import it directly into the database.
Drag & drop your JSON file here
or click to browse
Supported: .json (v2.0 normalized format)
Selected:
đ¤ Import Excel Hazard Log
Upload your Excel hazard log file to convert it to JSON format. Files are processed entirely in your browser - your data never leaves your computer.
Generic: Works with any hazard log format. Automatically detects column structure.
Drag & drop your Excel file here
or click to browse
Supported: .xlsx, .xls
â Add Controls to Existing Product
Upload an Excel file with additional controls to add to an existing product in the database.
Drag & drop your controls Excel file here
or click to browse
Supported: .xlsx, .xls
đ Expected Excel Format
Your Excel file should contain the following columns:
cause_id- ID of the cause this control mitigates (must exist in product)control_id- Unique identifier for the controlcontrol_description- Description of what the control doescontrol_type- Type (e.g., DESIGN, TRAINING, PROCESS)control_category- Category (e.g., initial, additional)evidence(optional) - Supporting evidence reference
đ Upload SPID/SCID Documents
Upload Structured Product Information Documents (SPID) or Structured Context Information Documents (SCID) in JSON format.
SPID: All products | SCID: DCB 0160 products only
đ Upload SPID
Structured Product Information Document (JSON format)
Drag & drop SPID JSON here
or click to browse
Supported: .json (validated against SPID schema)
Selected:
đĨ Upload SCID
Structured Context Information Document (JSON format)
Drag & drop SCID JSON here
or click to browse
Supported: .json (validated against SCID schema)
Selected:
âšī¸ Document Requirements
- SPID: Required for all products (DCB 0129 and DCB 0160)
- SCID: Required only for DCB 0160 products (deployment context)
- Documents must be valid JSON matching the SPID/SCID schema
- Each product can have one SPID and multiple SCIDs
- Validation is performed automatically before upload
đ No Hazard Log Data
Load a hazard log to start reviewing controls in Workshop mode.
Click on a node or edge to view details
Data Analyser
Load a hazard log file to see detailed statistics.
Export Options
Export your hazard log data in various formats. Customize filenames or use defaults with timestamp.
đĄ Tips
- Leave filename blank to use default format:
hazard_log_YYYY-MM-DD - Custom filenames will automatically add the appropriate extension (.json or .xlsx)
- Timestamps ensure unique filenames and prevent overwriting existing files
- All exports use the currently loaded hazard log data
đī¸ DATABASE
Manage products, SPID documents, and SCID documents
đĻ Products
Click "Refresh" to load products
đ SPID Documents
Click "Refresh" to load SPID documents
đ SCID Documents
Click "Refresh" to load SCID documents
đ¨ââī¸ Clinical Safety Officers (CSO)
Manage Clinical Safety Officers responsible for hazard log oversight and product safety. CSOs are assigned to products and sign off on safety assessments.
Click "Refresh" to load Clinical Safety Officers
đ Convert DCB 0129 to DCB 0160
Create a new DCB 0160 product by duplicating a DCB 0129 product and filtering for TRANSFERRED status hazards only. This workflow is commonly used when transitioning hazards from DCB0129 to DCB0160 standards.
Refresh to load available DCB 0129 products
New Product Metadata (DCB 0160)
âšī¸ How Conversion Works
- Only hazards with STATUS = "TRANSFERRED" will be included
- All causes linked to transferred hazards will be copied
- All controls linked to those causes will be copied
- All evidence linked to those controls will be copied
- The new product will have DCB = "0160"
- Original IDs will be preserved for traceability
- The source product remains unchanged
đĨ Health Information Technology Log
Manage health IT products used across deployment sites (from SCID documents Section E)
đ Select Organisation
đ Health IT Products
Select an organisation and click "Load HIT Log"
âšī¸ About HIT Log
The Health Information Technology Log tracks all IT products and systems used by healthcare organisations. This data is part of the SCID (Safety Case Information Document) Section E.
- View all HIT products for a selected organisation
- Edit product details including DCB compliance status
- Add new products to track
- Export data to Excel for reporting
- Track integration status with GP systems
- Monitor contract end dates and procurement details
Settings
Choose between light and dark color schemes
Choose a color palette optimized for color vision deficiency (red-green color blindness)
Color-blind mode uses blue-orange scale instead of green-red, with added icons for clarity
Choose which tab opens by default when loading a product
Default: Workshop tab (recommended for hazard review)
Choose your preferred font family for the entire application
Note: Font changes apply instantly across the entire application and are saved automatically.
Choose between collapsible sidebar or classic horizontal tabs
đĄ Sidebar navigation offers keyboard shortcuts (Ctrl+B), drag-to-resize, and pinnable tabs
â ī¸ Page will reload to apply navigation style changes
Customize ID prefixes for hazards, causes, controls, and evidence. ID format will be [PREFIX]-XXX where XXX is a 3-digit number (e.g., HAZ-001).
Note: These preferences will be used when generating new IDs for hazards, causes, controls, and evidence. Changes will take effect immediately after saving.
đ Admin Settings
Administrative functions for user management and audit logging
Manage user accounts and product access permissions
View system activity and compliance audit trail
Track all changes to entities and rollback to previous versions
Configure where user feedback is sent
Note: User feedback submitted via the header button will be emailed to this address. Default: support@curistica.com
Are you sure you want to delete this item?
Are you sure you want to delete this product?
This will permanently delete all associated:
- Hazards
- Causes
- Controls
- Evidence
- All relationships
This action cannot be undone.
Type DELETE to confirm:
Enter metadata for the duplicated project:
* Required fields
This will create a copy of this project configured for DCB 0160.
All hazards, causes, controls, and evidence will be copied to the new project.
This will be added to the project name: "Project Name 0160 @ [Location]"
What will be created:
âĸ DCB: 0160
âĸ Date: Today's date
âĸ Description: "draft 0160 created from [source project]"
