![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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/1.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/2.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/3.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/4.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/5.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/6.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/7.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/8.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/9.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/10.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/11.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/12.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/13.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/14.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/15.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/16.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/17.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/18.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/19.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/20.jpg)
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](https://reader034.vdocuments.mx/reader034/viewer/2022051821/5697bfd21a28abf838caba48/html5/thumbnails/21.jpg)
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