21
Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar ( [email protected] ) the best people make cosylab

Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar ([email protected])[email protected]

Embed Size (px)

Citation preview

Page 1: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

Safety demands strict documentation management(from initial requirements to the final design of the system)

Bojan Zalar ([email protected])

the best people make cosylab

Page 2: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

Cosylab 2010 2

part I – we are building a medical device

How can you assure the final system meets all requirements?

How do you know the final system is fully tested?

How do you know, which requirements are more important than others?

Page 3: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

How to achieve it?

Requirements must be traceable throughout entire development process

all requirements are: agreed, evaluated, and met … therefore we need traceability

Risks must be identified and mitigated

Work-flow environment and tools must support the above

Cosylab 2010 3

Page 4: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

Requirements must be traceable All requirements must be met

link from initial requirements to final verification

Every component of the system must be there for a reason

Proof of traceability: traceability matrix.

Cosylab 2010 4

Page 5: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

All requirements must be met

Cosylab 2010 5

Req#1

Comp#1

Comp#2

Comp#3

Test Case #1

Test Case #2

Test Case #3

Test Case #4

Test Report #1

Test Report #2

Test Report #3

Test Report #4

Req#2

Comp#1 Comp#2

Comp#3

Test Case #1 xTest Case #2 xTest Case #3 x xTest Case #4 x

Req#1 Req#2Comp#1 x xComp#2 xComp#3 x

Page 6: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

Every component of the system must be there for a reason

Cosylab 2010 6

Prevent over-engineering Reduce maintenance and upgrade

Req#1

Comp#1

Comp#2

Comp#3

Test Case #1

Test Case #2

Test Case #3

Test Case #4

Test Report #1

Test Report #2

Test Report #3

Test Report #4

Req#2

Comp#4

Test Case #5

Test Report #5

Req#1 Req#2Comp#1 x xComp#2 xComp#3 xComp#4

Page 7: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

Traceability matrix

Cosylab 2010 7

Page 8: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

Risks must be identified and mitigated

Certain device risks can result from faults

Take appropriate actions to minimize the risks

Verify that taken actions minimize the risks

Cosylab 2010 8

Requirements

Architecture & Design

Test Plan

Test Report

Risk Analysis

Risk Mitigation

DFMEA

Page 9: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

DFMEADesign Failure Mode and Effects Analysis

Key functions of the design are inspected Primary potential failures and causes of each failure are identified Actions are taken to reduce final risk

Cosylab 2010 9

Page 10: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

Work-flow environment and tools The tool must work well on big projects

The environment must be set in a way to allow tracking changes and keeping team aligned

Cosylab 2010 10

Page 11: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

The tool must work well on big projects MS Word is not enough, we need specialized tools

Custom made applications are too expensive

Enterprise Architect can easily handle big projects

Cosylab 2010 11

Page 12: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

Implementing The model in Enterprise Architect

Cosylab 2010 12

ReqsA&D

Tests

Reports

The model

Documents Requirements Architecture & Design Test Plan Test Report Traceability Matrix

People Architects Developers Testers

Page 13: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

Cosylab 2010 13

part II – hands-on in practice

Page 14: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

Collect information

Adding/modifying requirements Attributes, Figures

Linking requirements to Architecture and Test Cases No requirement is forgotten Each Component is there for a reason

Cosylab 2010 14

Page 15: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

Collect information

Cosylab 2010 15

Page 16: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

Traceability

Cosylab 2010 16

Page 17: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

Generate reports covering different perspectives Templates are defined according the EBG/MedAustron styles

Easy changing, creating new ones

Generating a MS Word document form the model is simple

Easily Searching for the specific information in the model Search/Generate for Approval Requirements

Cosylab 2010 17

Page 18: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

Cosylab 2010 18

Generate reports covering different perspectives

Page 19: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

Traceability matrix

Cosylab 2010 19

Page 20: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

Auditing - track model changes

Cosylab 2010 20

Page 21: Safety demands strict documentation management (from initial requirements to the final design of the system) Bojan Zalar (bojan.zalar@cosylab.com)bojan.zalar@cosylab.com

We are building medical device

Requirements must be traceable throughout entire development process

Risks must be identified and mitigated

Work-flow environment and tools must support the above

Cosylab 2010 21