@neobiotechlabs/neobiotech-dev-agent-codex 0.1.39

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (87) hide show
  1. package/.codex-plugin/plugin.json +36 -0
  2. package/.mcp.json +20 -0
  3. package/data/cyber_sec.png +0 -0
  4. package/data/hazard_panel.png +0 -0
  5. package/data/review-criteria.md +185 -0
  6. package/data/risk_score.png +0 -0
  7. package/dist/build/plantuml-1.2026.1.jar +0 -0
  8. package/dist/data/Courier-Bold.afm +342 -0
  9. package/dist/data/Courier-BoldOblique.afm +342 -0
  10. package/dist/data/Courier-Oblique.afm +342 -0
  11. package/dist/data/Courier.afm +342 -0
  12. package/dist/data/Helvetica-Bold.afm +2827 -0
  13. package/dist/data/Helvetica-BoldOblique.afm +2827 -0
  14. package/dist/data/Helvetica-Oblique.afm +3051 -0
  15. package/dist/data/Helvetica.afm +3051 -0
  16. package/dist/data/Symbol.afm +213 -0
  17. package/dist/data/Times-Bold.afm +2588 -0
  18. package/dist/data/Times-BoldItalic.afm +2384 -0
  19. package/dist/data/Times-Italic.afm +2667 -0
  20. package/dist/data/Times-Roman.afm +2419 -0
  21. package/dist/data/ZapfDingbats.afm +225 -0
  22. package/dist/data/sRGB_IEC61966_2_1.icc +0 -0
  23. package/dist/doctor.js +15106 -0
  24. package/dist/doctor.js.map +1 -0
  25. package/dist/fonts/LICENSE.txt +94 -0
  26. package/dist/fonts/Pretendard-Bold.ttf +0 -0
  27. package/dist/fonts/Pretendard-Regular.ttf +0 -0
  28. package/dist/index.js +185999 -0
  29. package/dist/index.js.map +1 -0
  30. package/dist/setup-codex.js +164 -0
  31. package/dist/setup-codex.js.map +1 -0
  32. package/package.json +34 -0
  33. package/skills/doc-render/SKILL.md +84 -0
  34. package/skills/role-document-content-reviewer/SKILL.md +68 -0
  35. package/skills/role-mdr-cybersecurity-reviewer/SKILL.md +47 -0
  36. package/skills/role-mdr-regulatory-architect/SKILL.md +48 -0
  37. package/skills/role-requirement-coverage-tracker/SKILL.md +108 -0
  38. package/skills/role-sw-architect/SKILL.md +61 -0
  39. package/vendor/dev-docs-templates/templates/dev_docs/plan_template.md +104 -0
  40. package/vendor/dev-docs-templates/templates/dev_docs/prd_template.md +110 -0
  41. package/vendor/dev-docs-templates/templates/dev_docs/spec_template.md +81 -0
  42. package/vendor/dev-docs-templates/templates/dev_docs/tasks_template.md +122 -0
  43. package/vendor/dev-docs-templates/templates/mdr_docs/CA/checklist-clinical-evaluation.md +81 -0
  44. package/vendor/dev-docs-templates/templates/mdr_docs/CA/checklist-gspr-mdr.md +403 -0
  45. package/vendor/dev-docs-templates/templates/mdr_docs/CA/clinical-evaluation-report.md +492 -0
  46. package/vendor/dev-docs-templates/templates/mdr_docs/CA/instructions-for-use.md +132 -0
  47. package/vendor/dev-docs-templates/templates/mdr_docs/CA/literature-evaluation-table.md +15 -0
  48. package/vendor/dev-docs-templates/templates/mdr_docs/CA/mdr-declaration-of-conformity.md +75 -0
  49. package/vendor/dev-docs-templates/templates/mdr_docs/CA/post-market-clinical-follow-up-plan.md +162 -0
  50. package/vendor/dev-docs-templates/templates/mdr_docs/CA/post-market-surveillance-plan.md +175 -0
  51. package/vendor/dev-docs-templates/templates/mdr_docs/CA/risk-management-cybersecurity-checklist.md +67 -0
  52. package/vendor/dev-docs-templates/templates/mdr_docs/CA/risk-management-report.md +111 -0
  53. package/vendor/dev-docs-templates/templates/mdr_docs/CA/usability-evaluation-report.md +70 -0
  54. package/vendor/dev-docs-templates/templates/mdr_docs/EA/clinical-evaluation-plan.md +154 -0
  55. package/vendor/dev-docs-templates/templates/mdr_docs/EA/list-of-hazard-related-use-scenarios.md +34 -0
  56. package/vendor/dev-docs-templates/templates/mdr_docs/EA/risk-table-fmea.md +155 -0
  57. package/vendor/dev-docs-templates/templates/mdr_docs/EA/software-architecture-description.md +307 -0
  58. package/vendor/dev-docs-templates/templates/mdr_docs/EA/software-detailed-design.md +321 -0
  59. package/vendor/dev-docs-templates/templates/mdr_docs/EA/software-requirements-list.md +156 -0
  60. package/vendor/dev-docs-templates/templates/mdr_docs/EA/soup-list.md +82 -0
  61. package/vendor/dev-docs-templates/templates/mdr_docs/EA/usability-evaluation-plan.md +103 -0
  62. package/vendor/dev-docs-templates/templates/mdr_docs/ER/global/bug-fixes-documentation-list.md +35 -0
  63. package/vendor/dev-docs-templates/templates/mdr_docs/ER/global/change-evaluation-list.md +100 -0
  64. package/vendor/dev-docs-templates/templates/mdr_docs/ER/global/list-of-known-anomalies.md +29 -0
  65. package/vendor/dev-docs-templates/templates/mdr_docs/ER/sprint/algorithm-validation-report.md +170 -0
  66. package/vendor/dev-docs-templates/templates/mdr_docs/ER/sprint/checklist-software-release.md +52 -0
  67. package/vendor/dev-docs-templates/templates/mdr_docs/ER/sprint/checklist-software-requirements-review.md +50 -0
  68. package/vendor/dev-docs-templates/templates/mdr_docs/ER/sprint/software-architecture-checklist.md +41 -0
  69. package/vendor/dev-docs-templates/templates/mdr_docs/ER/sprint/software-system-test-plan.md +155 -0
  70. package/vendor/dev-docs-templates/templates/mdr_docs/ER/sprint/usability-evaluation-protocol.md +63 -0
  71. package/vendor/dev-docs-templates/templates/mdr_docs/PA/configuration-management-plan.md +112 -0
  72. package/vendor/dev-docs-templates/templates/mdr_docs/PA/intended-use.md +116 -0
  73. package/vendor/dev-docs-templates/templates/mdr_docs/PA/mdr-classification-document.md +114 -0
  74. package/vendor/dev-docs-templates/templates/mdr_docs/PA/risk-management-plan.md +198 -0
  75. package/vendor/dev-docs-templates/templates/mdr_docs/PA/security-management-plan.md +101 -0
  76. package/vendor/dev-docs-templates/templates/mdr_docs/PA/software-development-maintenance-plan.md +213 -0
  77. package/vendor/dev-docs-templates/templates/mdr_docs/PA/system-requirements-spec.md +182 -0
  78. package/vendor/dev-docs-templates/templates/mdr_docs/global/information_security/information-security-controls.md +966 -0
  79. package/vendor/dev-docs-templates/templates/mdr_docs/global/information_security/information-security-policy-and-scope.md +99 -0
  80. package/vendor/dev-docs-templates/templates/mdr_docs/global/qms/quality-manual-policy-objectives.md +187 -0
  81. package/vendor/dev-docs-templates/templates/mdr_docs/global/qms/sop-capa.md +112 -0
  82. package/vendor/dev-docs-templates/templates/mdr_docs/global/qms/sop-change-management.md +128 -0
  83. package/vendor/dev-docs-templates/templates/mdr_docs/global/qms/sop-clinical-evaluation.md +102 -0
  84. package/vendor/dev-docs-templates/templates/mdr_docs/global/qms/sop-feedback-management.md +140 -0
  85. package/vendor/dev-docs-templates/templates/mdr_docs/global/qms/sop-integrated-software-development.md +361 -0
  86. package/vendor/dev-docs-templates/templates/mdr_docs/global/qms/sop-post-market-surveillance.md +159 -0
  87. package/vendor/dev-docs-templates/templates/mdr_docs/global/qms/sop-software-problem-resolution.md +99 -0
@@ -0,0 +1,170 @@
1
+ > DISCLAIMER:
2
+ >
3
+ > You may not need this template. It's aimed companies that develop devices including ML algorithms. Why do
4
+ > they need this template?
5
+ >
6
+ > Due to the "blackbox" nature of many of those algorithms, their functionalities typically can't be verified
7
+ > in the same sense as code reviews can verify correct coding in the world of old-school software
8
+ > development. That's why they can only be validated by subjecting the model to rigorous testing on separate
9
+ > test datasets. This report is the place to document all the results (e.g. sensitivity, specificity,
10
+ > accuracy, ROC curve values, discussion of outlayers, edge cases, etc.). Side note: there's a disconnect
11
+ > between what data science and regulatory affairs understands as validation and verification. Don't get
12
+ > confused!
13
+
14
+ # 1. General Information
15
+
16
+ This document describes the specification of our machine learning (algorithm) model and its testing strategy.
17
+
18
+ > Keep in mind that the results of the algorithm validation should also serve as input to and be referenced in
19
+ > your clinical evaluation / performance evaluation report.
20
+
21
+ **Regulatory references:**
22
+
23
+ | ISO 13485:2016 Section | Document Section |
24
+ |--------------------------|------------------|
25
+ | 6.2; 7.3.2 | 2.1 |
26
+ | 7.3.7 | 2.3; 3.1; 3.2 |
27
+ | 4.2.3; 5.2; 7.2.1; 7.3.3 | 2.4 |
28
+ | 4.1; 7.3.6 | 3 |
29
+ | 7.3.2; 7.3.6; 7.3.7 | 5 |
30
+
31
+ | ISO 14971:2019 Section | Document Section |
32
+ |------------------------|------------------|
33
+ | 4.3 | 2.1 |
34
+ | 5.2 | 2.4 |
35
+
36
+ | ISO 82304:2016 Section | Document Section |
37
+ |------------------------|------------------|
38
+ | 6.1 | 2.1 |
39
+
40
+ | ISO 62366-1:2015 Section | Document Section |
41
+ |--------------------------|------------------|
42
+ | 5.1; 5.2 | 2.4 |
43
+
44
+ | ISO 62304:2006 Section | Document Section |
45
+ |------------------------|------------------|
46
+ | 5.3; 8.1.2 | 2.2 |
47
+ | 5.2 | 2.4 |
48
+
49
+ | ISO/IEC 24028:2020 Section | Document Section |
50
+ |----------------------------|------------------|
51
+ | 9.8.1; 10.5 | 3.1; 3.2 |
52
+ | 9.8.2.1 | 3.2 |
53
+ | 9.8.2.2 | 4 |
54
+
55
+ **Relevant other documentation:**
56
+
57
+ * SOP Software Development
58
+ * Software Development and Maintenance Plan
59
+ * SOUP List
60
+
61
+ # 2. Development Resources
62
+
63
+ For more context information, refer to the device’s software development and maintenance plan.
64
+
65
+ ## 2.1. Developer Team
66
+
67
+ | Name | Role | Qualification |
68
+ |-------|-------|---------------|
69
+ | (...) | (...) | (...) |
70
+
71
+ ## 2.2. SOUP / Frameworks
72
+
73
+ | Name | Version |
74
+ |---------|---------|
75
+ | PyTorch | (...) |
76
+
77
+ ## 2.3. Data
78
+
79
+ | Count | Description |
80
+ |-------|-------------------------------------------------------|
81
+ | | \<e.g. annotated heart rate dataset from a wearable\> |
82
+
83
+ ## 2.4. Development Planning
84
+
85
+ Optional: remove or add to the following sub-paragraphs as appropriate.
86
+
87
+ **Intended Purpose**
88
+
89
+ > Reference intended use; describe intended task the model should solve.
90
+
91
+ (...)
92
+
93
+ **Clinical Environment**
94
+
95
+ > Reference clinical evaluation plan; describe clinical context in which the model will be used.
96
+
97
+ (...)
98
+
99
+ **Software Architecture**
100
+
101
+ > Reference software architecture (diagram); describe how the model will be embedded in the overall system and
102
+ > how it will interact with other software components.
103
+
104
+ (...)
105
+
106
+ **Quality Requirements**
107
+
108
+ > Reference clinical evaluation plan; describe quality criteria that shall apply to the model, for example,
109
+ > quantify values for sensitivity / specificity, AUC, positive/negative predictive value, accuracy,
110
+ > repeatability. Also, provide justification for why certain parameters may not apply and compare your
111
+ > approach to the current state of the art / technology.
112
+
113
+ (...)
114
+
115
+ # 3. Data Management
116
+
117
+ ## 3.1. Data Acquisition
118
+
119
+ > Describe how you acquired your data (sources, inclusion / exclusion criteria, possible biases, data
120
+ > protection measures, etc). Give a rough estimate of what size of datasets are required.
121
+ >
122
+ > If applicable, reference relevant QMS processes.
123
+
124
+ (...)
125
+
126
+ ## 3.2. Data Annotation
127
+
128
+ > Describe how data is labeled and how you determined the ground truth. Further, you can describe: labeling
129
+ > requirements (quality criteria), qualification / training of staff involved, quality assurance for correct
130
+ > labeling. If applicable, reference relevant QMS processes.
131
+
132
+ (...)
133
+
134
+ ## 3.3. Data Pre-Processing
135
+
136
+ > Describe how you pre-processed data. Possible steps may include: anonymization / pseudonymization, removing
137
+ > data elements, converting data formats or units, handling missing values or data outliers. How did you
138
+ > divide data into training, validation and test data. If applicable, reference relevant QMS processes.
139
+
140
+ (...)
141
+
142
+ # 4. Algorithm Model Training and Description
143
+
144
+ > Describe your algorithm model. For example: which type of model (e.g. CNN) is used? Optionally, add a graph
145
+ > or diagram to explain the model architecture. Describe model training; e.g. selection of features, (most
146
+ > important) hyperparameters, etc.
147
+
148
+ (...)
149
+
150
+ # 5. Algorithm Model Evaluation
151
+
152
+ > Describe how testing is done: describe your test data set, which metrics are used for evaluation and which
153
+ > values are deemed acceptable.
154
+
155
+ (...)
156
+
157
+ # 6. Conclusion
158
+
159
+ > Discuss your evaluation results: why do they meet predefined quality criteria, why is the model fit for
160
+ > purpose in accordance with the medical device’s intended use? Take into account possible risks, biases and
161
+ > limitations.
162
+
163
+ (...)
164
+
165
+ ---
166
+
167
+ Template Copyright [openregulatory.com](https://openregulatory.com). See [template
168
+ license](https://openregulatory.com/template-license).
169
+
170
+ Please don't remove this notice even if you've modified contents of this template.
@@ -0,0 +1,52 @@
1
+ # Checklist: Software Release
2
+
3
+ | Classes | IEC 62304:2006 Section | Document Section |
4
+ | ------- | ---------------------- | ---------------- |
5
+ | A, B, C | 5.8.1 | (All) |
6
+ | A, B, C | 5.8.2 | (All) |
7
+ | A, B, C | 5.8.3 | (All) |
8
+ | A, B, C | 5.8.4 | (All) |
9
+ | B, C | 5.8.5 | (All) |
10
+ | B, C | 5.8.6 | (All) |
11
+ | A, B, C | 5.8.7 | (All) |
12
+
13
+ ## Summary
14
+
15
+ This checklist is used to verify that documentation and activities are complete before releasing a new version of the product.
16
+
17
+ > As with all regulatory documents, it's more about the content than about the tool. You don't have to fill this checklist out every time in Word / GDocs / etc., but could embed it in your Jira / GitHub workflow. The main point is that, at minimum, the items below should be checked (and documented) before you release a new version of your software.
18
+
19
+ > Feel free to add further rows in the checklist if they make sense for your company. This template is pretty much the bare minimum to be 62304-compliant.
20
+
21
+ ## Checklist
22
+
23
+ The following documents are up to date:
24
+
25
+ > The table below shows examples only. Add - or reference - a list of all your required TechDoc records.
26
+
27
+ | Item | Yes | No | Comment |
28
+ | ---- | --- | --- | ------- |
29
+ | Device Description | | | |
30
+ | Clinical Evaluation | | | |
31
+ | Declaration of Conformity | | | |
32
+ | (...) | | | |
33
+
34
+ The following activities have been performed:
35
+
36
+ | Item | Yes | No | Comment |
37
+ | ---- | --- | --- | ------- |
38
+ | All relevant functionalities of the software have been specified; the Software Requirement List is complete and has been reviewed. | | | |
39
+ | All relevant risks (including risks of known anomalies) have been evaluated; the Risk Management Report is complete. | | | |
40
+ | Verification (as software system testing) has been completed. | | | |
41
+ | Design control traceability is ensured:<br>Stakeholder requirements can be traced to software requirements.<br>Software requirements can be traced to system tests.<br>Software requirements can be traced to software code implementation / software code reviews.<br>Software requirements can be traced to risks and risk control measures.<br>Stakeholder requirements can be traced to usability tests.<br>Hazard-related use scenarios can be traced to usability tests.<br>Hazard-related use scenarios can be traced to risks and risk control measures. | | | |
42
+ | A version number as defined in the Software Development Plan has been assigned and added as a tag to git. | | | |
43
+ | Software is registered with a Notified Body. | | | |
44
+ | If release includes substantial change: Notified Body has been informed. | | | |
45
+ | Label is applied correctly including CE marking. | | | |
46
+
47
+ ---
48
+
49
+ Template Copyright [openregulatory.com](https://openregulatory.com). See [template
50
+ license](https://openregulatory.com/template-license).
51
+
52
+ Please don't remove this notice even if you've modified contents of this template.
@@ -0,0 +1,50 @@
1
+ # Checklist: Software Requirements Review
2
+
3
+ | Classes | IEC 62304:2006 Section | Document Section |
4
+ |---------|------------------------|------------------|
5
+ | A, B, C | 5.2.6 | (All) |
6
+
7
+ | ISO 13485:2016 Section | Document Section |
8
+ |------------------------|------------------|
9
+ | 7.3.3 | (All) |
10
+ | 7.3.5 | (All) |
11
+
12
+ ## 1. Summary
13
+
14
+ This checklist is used to review (verify) software requirements prior to implementation.
15
+
16
+ > As with all regulatory documents, it's more about the content than about the tool. You don't have to fill
17
+ > this checklist out every time in Word / GDocs / etc., but could embed it in your Jira / GitHub workflow. The
18
+ > main point is that, at minimum, the items below should be filled out before you start implementing software
19
+ > requirements.
20
+
21
+ > Feel free to add further rows in the checklist if they make sense for your company. This template is pretty
22
+ > much the bare minimum to be 62304-compliant.
23
+
24
+ ## 2. Checklist
25
+
26
+ | Software Requirements... | Yes | No | Comment |
27
+ |-------------------------------------------------------------------------------|-----|----|---------|
28
+ | are traceable to design input or risk control measures. | | | |
29
+ | are complete. | | | |
30
+ | are understandable, uniquely identifiable and do not contradict each other. | | | |
31
+ | include user interface requirements (mockups, wireframes, etc.), if relevant. | | | |
32
+ | include IT security requirements, if relevant. | | | |
33
+ | are testable and include acceptance criteria. | | | |
34
+
35
+ # 3. Comments
36
+
37
+ \<Insert comments if applicable\>
38
+
39
+ # 4. Result
40
+
41
+ [ ] Software Requirements passed\
42
+ [ ] Software Requirements not passed\
43
+ [ ] Software Requirements passed with the following obligations: \<Insert if applicable\>\
44
+
45
+ ---
46
+
47
+ Template Copyright [openregulatory.com](https://openregulatory.com). See [template
48
+ license](https://openregulatory.com/template-license).
49
+
50
+ Please don't remove this notice even if you've modified contents of this template.
@@ -0,0 +1,41 @@
1
+ # Software Architecture Checklist
2
+
3
+ **Regulatory references:**
4
+
5
+ IEC 62304, para. 5.3.6 [class B, C]
6
+
7
+ **Relevant other documentation:**
8
+
9
+ * SOP Software Development
10
+ * User needs / stakeholder requirements
11
+ * Design input / software requirements
12
+ * Software architecture description
13
+ * (...)
14
+
15
+ # 1. Checklist
16
+
17
+ | Criteria | Pass / Fail |
18
+ |----------------------------------------------------------------------------------------------------------|-------------------------|
19
+ | The software architecture is in agreement with the software requirements. | ( ) Yes<br>( ) Improve: |
20
+ | All software systems are listed and their respective safety class is stated. | ( ) Yes<br>( ) Improve: |
21
+ | All software components are listed and described, including interfaces. | ( ) Yes<br>( ) Improve: |
22
+ | All software units are listed and described. | ( ) Yes<br>( ) Improve: |
23
+ | (Optional) Further architecture is described, e.g. databases, security and data protection requirements. | ( ) Yes<br>( ) Improve: |
24
+ | The software architecture can be implemented with our given resources. | ( ) Yes<br>( ) Improve: |
25
+
26
+ # 2. Comments
27
+
28
+ \<Insert comments if applicable\>
29
+
30
+ # 3. Results
31
+
32
+ ( ) Software Architecture passed\
33
+ ( ) Software Architecture not passed\
34
+ ( ) Software Architecture passed with the following obligations: \<Insert if applicable\>\
35
+
36
+ ---
37
+
38
+ Template Copyright [openregulatory.com](https://openregulatory.com). See [template
39
+ license](https://openregulatory.com/template-license).
40
+
41
+ Please don't remove this notice even if you've modified contents of this template.
@@ -0,0 +1,155 @@
1
+ # Software System Test Plan & Protocol: {PRODUCT_NAME} v{VERSION}
2
+
3
+ <!-- AI AGENT 작성 지침
4
+ 이 문서는 IEC 62304 Cl.5.7 기반 시스템 테스트 계획서입니다.
5
+ Sprint마다 테스트 케이스를 추가/업데이트하세요.
6
+
7
+ 작성 전 반드시 다음 문서를 참조하세요:
8
+ - SW 요구사항 명세서(software-requirements-list.md): 모든 SRS ID를 테스트 케이스로 커버해야 함
9
+ - FMEA(risk-table-fmea.md): 위험 통제 조치가 구현되었는지 검증하는 테스트 포함
10
+ - 사이버보안 체크리스트(risk-management-cybersecurity-checklist.md): 보안 테스트 항목 반영
11
+
12
+ 작성 지침:
13
+ 1. 모든 SRS 요구사항(SRS-F-xxx, SRS-P-xxx 등)에 최소 1개의 테스트 케이스가 있어야 합니다
14
+ 2. 테스트 ID 체계: TST-SYS-{N:3d} (예: TST-SYS-001)
15
+ 3. 테스트 결과 컬럼은 실제 테스트 실행 후 채워주세요 (계획서는 Expected까지만)
16
+ 4. 위험 통제 조치에 대한 테스트는 "위험 통제 검증?" 열을 Yes로 표시하세요
17
+ 5. Pass/Fail 외에 Blocked(사전 조건 미충족), N/A(해당 없음)도 사용 가능합니다
18
+
19
+ 테스트 카테고리:
20
+ - Functional: SRS-F-xxx 기능 요구사항 검증
21
+ - Performance: SRS-P-xxx 성능 요구사항 검증
22
+ - Security: SRS-S-xxx 보안 요구사항 검증
23
+ - Regression: 이전 버전에서 동작하던 기능이 유지되는지 확인
24
+ - Boundary: 경계값 조건 검증 (허용 범위 초과/미만 입력)
25
+
26
+ 테스트 환경 (필수 기재):
27
+ - 테스트 환경은 실제 사용 환경과 유사해야 합니다 (IEC 62304 Cl.5.7.2)
28
+ - 사용된 SOUP 버전을 명시하세요 (SOUP 리스트와 일치 확인)
29
+ -->
30
+
31
+ **문서 번호**: {DOC_ID}
32
+ **버전**: {VERSION} | **상태**: Draft (계획) / Final (프로토콜)
33
+ **Sprint**: {SPRINT_NUMBER} | **작성일**: {DATE}
34
+ **테스터**: {TESTER} | **검토자**: {REVIEWER}
35
+
36
+ ---
37
+
38
+ ## 표준 요건 매핑
39
+
40
+ | 표준 조항 | 제목 | 해당 섹션 |
41
+ | ------------------ | ----------------------------- | ------------------ |
42
+ | IEC 62304 Cl.5.7.1 | 통합 시스템 테스트 절차 수립 | 전체 |
43
+ | IEC 62304 Cl.5.7.2 | 소프트웨어 시스템 테스트 수행 | 3. 테스트 케이스 |
44
+ | IEC 62304 Cl.5.7.4 | 테스트 결과와 요구사항 추적성 | 4. 추적성 매트릭스 |
45
+ | MDR Annex II 6.1 | 제품 검증 | 전체 |
46
+
47
+ ---
48
+
49
+ ## 1. 테스트 환경 (Test Environment)
50
+
51
+ <!-- AI AGENT: 실제 테스트를 수행한 환경을 정확하게 기재하세요 -->
52
+
53
+ | 항목 | 사양 |
54
+ | ------------------ | ---------------------------------- |
55
+ | OS / 환경 | {OS_VERSION} |
56
+ | 주요 SOUP 버전 | {SOUP_NAME} v{VERSION} (SOUP-{ID}) |
57
+ | 브라우저 / 런타임 | {BROWSER_OR_RUNTIME} |
58
+ | 테스트 데이터 출처 | {TEST_DATA_SOURCE} |
59
+ | 테스트 실행 일시 | {TEST_DATE} |
60
+
61
+ ---
62
+
63
+ ## 2. 테스트 범위 (Test Scope)
64
+
65
+ | 포함 | 제외 |
66
+ | ---------------------------- | ------------------------------------ |
67
+ | {IN_SCOPE_TEST} | {OUT_OF_SCOPE_TEST} |
68
+ | SRS-F-xxx 전체 기능 요구사항 | 유닛 레벨 테스트 (별도 SDD에서 관리) |
69
+
70
+ ---
71
+
72
+ ## 3. 테스트 케이스 (Test Cases)
73
+
74
+ ### 3.1 기능 테스트 (Functional Tests)
75
+
76
+ <!-- AI AGENT: 각 SRS-F-xxx 요구사항에 대한 테스트 케이스를 작성하세요
77
+ 테스트 단계(Steps)는 재현 가능하도록 구체적으로 작성해야 합니다
78
+ 예시:
79
+ Steps: 1. {URL}에 접속한다 2. 사용자 ID {ID}와 비밀번호 {PW}를 입력한다 3. 로그인 버튼을 클릭한다
80
+ Expected: 대시보드 페이지로 이동하고 사용자 이름이 표시된다 -->
81
+
82
+ | 테스트 ID | SRS ID | 테스트 카테고리 | 테스트 설명 | 사전 조건 | 테스트 단계 | 예상 결과 | 위험 통제 검증? | 실제 결과 | Pass? |
83
+ | ----------- | --------- | --------------- | ------------- | ----------- | -------------------------- | ------------ | --------------- | --------- | ----- |
84
+ | TST-SYS-001 | SRS-F-001 | Functional | {TEST_DESC_1} | {PRECOND_1} | 1. {STEP_1}<br>2. {STEP_2} | {EXPECTED_1} | Yes / No | | |
85
+ | TST-SYS-002 | SRS-F-002 | Functional | {TEST_DESC_2} | {PRECOND_2} | 1. {STEP_1}<br>2. {STEP_2} | {EXPECTED_2} | No | | |
86
+
87
+ ### 3.2 성능 테스트 (Performance Tests)
88
+
89
+ | 테스트 ID | SRS ID | 테스트 카테고리 | 테스트 설명 | 허용 기준 | 측정 방법 | 실제 결과 | Pass? |
90
+ | ------------- | --------- | --------------- | -------------- | --------- | -------------------- | --------- | ----- |
91
+ | TST-SYS-P-001 | SRS-P-001 | Performance | 응답 시간 측정 | <= {N}초 | {MEASUREMENT_METHOD} | {ACTUAL} | |
92
+
93
+ ### 3.3 보안 테스트 (Security Tests)
94
+
95
+ <!-- AI AGENT: SRS-S-xxx 보안 요구사항에 대한 테스트를 작성하세요
96
+ 다음 항목을 포함하는 것을 권장합니다:
97
+ - 인증 실패 케이스 (잘못된 자격증명, 세션 만료)
98
+ - 권한 없는 접근 시도
99
+ - SQL Injection / XSS 방어 확인
100
+ - TLS 통신 암호화 확인 -->
101
+
102
+ | 테스트 ID | SRS ID | 테스트 카테고리 | 테스트 설명 | 예상 결과 | 위험 통제 검증? | 실제 결과 | Pass? |
103
+ | ------------- | --------- | --------------- | -------------------- | -------------------------------------- | --------------- | --------- | ----- |
104
+ | TST-SYS-S-001 | SRS-S-001 | Security | {SECURITY_TEST_1} | {EXPECTED} | Yes | | |
105
+ | TST-SYS-S-002 | SRS-S-002 | Security | TLS 통신 암호화 확인 | Wireshark 캡처 시 암호화된 패킷만 관측 | Yes | | |
106
+
107
+ ### 3.4 경계값 테스트 (Boundary Tests)
108
+
109
+ | 테스트 ID | SRS ID | 테스트 카테고리 | 테스트 조건 | 입력값 | 예상 결과 | 실제 결과 | Pass? |
110
+ | ------------- | --------- | --------------- | -------------- | ------------ | ----------------- | --------- | ----- |
111
+ | TST-SYS-B-001 | SRS-F-{N} | Boundary | 최대값 입력 | {MAX_VALUE} | {EXPECTED} | | |
112
+ | TST-SYS-B-002 | SRS-F-{N} | Boundary | 최소값 입력 | {MIN_VALUE} | {EXPECTED} | | |
113
+ | TST-SYS-B-003 | SRS-F-{N} | Boundary | 범위 초과 입력 | {OVER_VALUE} | 오류 처리 및 거부 | | |
114
+
115
+ ---
116
+
117
+ ## 4. 추적성 매트릭스 (Traceability Matrix)
118
+
119
+ <!-- AI AGENT: 모든 SRS 요구사항이 테스트에 의해 커버되는지 확인하세요 -->
120
+
121
+ | SRS ID | 요구사항 설명 | 테스트 ID | 위험 ID | 커버 여부 |
122
+ | --------- | -------------- | ------------- | --------- | --------- |
123
+ | SRS-F-001 | {REQ_DESC} | TST-SYS-001 | - | Yes |
124
+ | SRS-S-001 | {SEC_REQ_DESC} | TST-SYS-S-001 | {RISK_ID} | Yes |
125
+
126
+ ---
127
+
128
+ ## 5. 테스트 결과 요약 (Test Results Summary)
129
+
130
+ <!-- AI AGENT: 테스트 완료 후 아래 표를 채워주세요 -->
131
+
132
+ | 카테고리 | 전체 | Pass | Fail | Blocked | N/A |
133
+ | ----------- | ---- | ---- | ---- | ------- | --- |
134
+ | Functional | {N} | | | | |
135
+ | Performance | {N} | | | | |
136
+ | Security | {N} | | | | |
137
+ | Boundary | {N} | | | | |
138
+ | **합계** | | | | | |
139
+
140
+ **결론**: Pass / Fail / Conditional Pass
141
+
142
+ **미해결 결함 목록**: (없음 또는 bug-fixes-documentation-list.md 참조)
143
+
144
+ ---
145
+
146
+ ## 6. 변경 이력
147
+
148
+ | 버전 | 날짜 | 작성자 | 변경 내용 |
149
+ | ---- | ------ | -------- | --------------------- |
150
+ | 0.1 | {DATE} | {AUTHOR} | 계획서 초안 |
151
+ | 1.0 | {DATE} | {TESTER} | 테스트 결과 입력 완료 |
152
+
153
+ ---
154
+
155
+ > Template based on IEC 62304:2006/AMD1:2015 Clause 5.7, MDR 2017/745 Annex II 6.1
@@ -0,0 +1,63 @@
1
+ # Usability Evaluation Protocol
2
+
3
+ ## Mapping of Standard Requirements to Document Sections
4
+
5
+ | IEC 62366-1:2015 Section | Title | Document Section |
6
+ |--------------------------|-----------------------------------------------|------------------|
7
+ | 4.2 | Usability Engineering File | (all) |
8
+ | 4.3 | Tailoring of the Usability Engineering effort | (all) |
9
+
10
+ ## 1. User Group and Environment
11
+
12
+ > Describe the user group here, e.g., physicians with experience in a certain field.
13
+
14
+ > Also, describe the environment in which the user test is being conducted. Obviously, both the user group and
15
+ > environment should match whatever you described in your Intended Use. So, if your app is intended to be used
16
+ > by emergency physicians in a brightly-lit hospital environment, you should also have these people do the
17
+ > usability test in a similar environment.
18
+
19
+ ## 2. Preparation
20
+
21
+ > Describe whether you prepare users in any way. Again, this should be based on the use context in which your
22
+ > users will be using your device in real life. So, if people typically carefully read the user manual before
23
+ > (not sure in which parallel universe that happens), you can give them the manual and some time to study
24
+ > it. More realistically, you'll probably test how users handle your device when they haven't read the manual.
25
+
26
+ > If there are official training which are required before users can use your device, you should do this
27
+ > training first, of course.
28
+
29
+ ## 3. List of Tasks
30
+
31
+ > This table lists the tasks you want your users to perform. It's kind of the master table which will be
32
+ > copy-pasted for each user below - you'll be filling out the observations and hazards encountered by each
33
+ > user.
34
+
35
+ > As always, using a spreadsheet (e.g., Google Sheets) instead of a document is a very good idea here.
36
+
37
+ | ID | Description | App State / Environment | Instructions | Acceptance Criteria | Observations | Hazards encountered |
38
+ |----|-------------|-------------------------|--------------|---------------------|--------------|---------------------|
39
+ | | | | | | | |
40
+
41
+ ## 4. Protocols
42
+
43
+ > Copy-paste the table above for each user and fill it out during the test. Note down the names and ages (or
44
+ > any other important characteristics) per user.
45
+
46
+ ### User 1 (Name, Age)
47
+
48
+ | ID | Description | App State / Environment | Instructions | Acceptance Criteria | Observations | Hazards encountered |
49
+ |----|-------------|-------------------------|--------------|---------------------|--------------|---------------------|
50
+ | | | | | | | |
51
+
52
+ ### User 2 (Name, Age)
53
+
54
+ | ID | Description | App State / Environment | Instructions | Acceptance Criteria | Observations | Hazards encountered |
55
+ |----|-------------|-------------------------|--------------|---------------------|--------------|---------------------|
56
+ | | | | | | | |
57
+
58
+ ---
59
+
60
+ Template Copyright [openregulatory.com](https://openregulatory.com). See [template
61
+ license](https://openregulatory.com/template-license).
62
+
63
+ Please don't remove this notice even if you've modified contents of this template.
@@ -0,0 +1,112 @@
1
+ # Configuration Management Plan
2
+
3
+ <!-- AI AGENT 작성 지침
4
+ 이 문서는 IEC 62304 §8 (Configuration Management Process) 기반 형상관리 계획서입니다.
5
+ PA 단계에서 작성하는 핵심 산출물로, 본 문서가 형상관리의 단일 진실의 원천입니다.
6
+ SDMP(Software Development and Maintenance Plan)는 본 문서를 참조합니다.
7
+
8
+ 작성 전 반드시 다음 문서를 참조하세요:
9
+ - 소프트웨어 개발 및 유지보수 계획서(software-development-maintenance-plan.md): 개발 워크플로우, 도구 체인
10
+ - 시스템 요구사항 명세서(system-requirements-spec.md): 타겟 환경, 구성 항목 후보
11
+ - SOP Change Management (회사 QMS 자산; 시드 템플릿 global/qms/sop-change-management.md):
12
+ 회사 수준의 변경 평가·통제 절차. CMP는 본 기기의 형상관리를, SOP는 회사 전체의
13
+ 변경 통제 절차를 다룬다(상호 보완). 첫 기기 개발 시 회사 QMS asset이 아직 없으면
14
+ 상기 시드 템플릿으로 자사 SOP를 먼저 작성할 것.
15
+
16
+ 작성 지침:
17
+ 1. Section 2 (형상 식별): 형상 항목(CI) 후보를 식별하세요 — 소스 코드, 빌드 스크립트, SOUP, 문서, 환경 설정
18
+ 2. Section 3 (버전 통제): 버전 네이밍 체계(시맨틱 버저닝)와 태그 정책을 정의하세요
19
+ 3. Section 4 (변경 통제): Change Evaluation List 연계 절차를 기술하세요
20
+ 4. Section 5 (형상 감사): 감사 주기·기준을 정의하세요
21
+ 5. 본 문서는 PA 'Plan' 성격 — 구현 세부(도구 세부 설정 등)는 EA/운영 단계로 미룸
22
+
23
+ 완성 체크리스트:
24
+ [ ] 형상 항목(CI) 식별 기준 명시
25
+ [ ] 버전 넘버링·태그 정책 정의
26
+ [ ] 변경 통제 절차(SOP Change Management 연계) 기술
27
+ [ ] 형상 감사 일정·기준 정의
28
+ [ ] 형상 관리 담당자(Configuration Manager) 지정
29
+ -->
30
+
31
+ {PROJECT_NAME}의 소프트웨어 형상관리 계획서. 본 문서는 IEC 62304 §8에 따라 형상관리 프로세스를
32
+ 정의하며, 모든 형상 관리 활동의 단일 진실의 원천이다. 작성자: {AUTHOR}, 티켓: {TICKET_ID}, 일자: {DATE}.
33
+
34
+ ## Mapping of Standard Requirements to Document Sections
35
+
36
+ | Standard | Clause | Document Section |
37
+ | ----------------------- | ------------------------------------------------------------------- | ---------------- |
38
+ | IEC 62304 | 5.1.9 Software Configuration Management Planning | 3 |
39
+ | IEC 62304 | 5.1.10 Supporting Items to be Controlled | 2 |
40
+ | IEC 62304 | 5.1.11 Software Configuration Item Control Before Verification | 7 |
41
+ | IEC 62304 | 8.1 Configuration Identification | 2 |
42
+ | IEC 62304 | 8.2 Change Control | 4 |
43
+ | IEC 62304 | 8.3 Configuration Status Accounting | 5 |
44
+ | IEC 62304 | 8.4 Configuration Audit | 6 |
45
+ | ISO 13485:2016 | 7.3.7 Design and Development Verification (configuration aspects) | 6, 7 |
46
+ | ISO 13485:2016 | 7.5 Document Control (applied to configuration items) | 3 |
47
+
48
+ ## 1. Purpose and Scope
49
+
50
+ > 이 계획서의 목적과 적용 범위를 기술하세요. 어떤 소프트웨어 제품/버전에 적용되는지 명시.
51
+
52
+ {SCOPE_DESCRIPTION}
53
+
54
+ ## 2. Configuration Identification
55
+
56
+ > 형상 항목(Configuration Item, CI)을 식별하는 기준을 정의하세요. 각 CI는 고유 식별자·버전을 갖는다.
57
+
58
+ 형상 항목 후보:
59
+ * 소스 코드 (레포지토리 단위)
60
+ * 빌드 스크립트 및 환경 설정 (CI/CD 파이프라인 정의 포함)
61
+ * SOUP (third-party 의존성, lockfile)
62
+ * 소프트웨어 문서 (요구사항·설계·테스트 산출물)
63
+ * 빌드 산출물 (release artifact)
64
+
65
+ | CI Category | Naming Convention | Tool |
66
+ | -------------- | ----------------- | -------------- |
67
+ | {CI_CATEGORY} | {CI_NAMING} | {CI_TOOL} |
68
+
69
+ ## 3. Version Control
70
+
71
+ > 버전 네이밍 체계와 태그 정책을 정의하세요. 시맨틱 버저닝(MAJOR.MINOR.PATCH) 권장.
72
+
73
+ * 버전 체계: {VERSION_SCHEME} (예: Semantic Versioning 2.0.0)
74
+ * 태그 정책: {TAG_POLICY} (각 release 커밋에 tag 부여, 과거 버전 복원 가능해야 함)
75
+ * 버전 관리 도구: Git
76
+
77
+ ## 4. Change Control
78
+
79
+ > 변경 통제 절차를 기술하세요. SOP Change Management와 연계.
80
+
81
+ 변경 요청 → 영향 평가(Change Evaluation List) → 승인 → 구현 → 검증의 흐름을 따른다.
82
+ 자세한 절차는 SOP Change Management를 참조한다. 본 절에서는 소프트웨어 형상 항목에
83
+ 특화된 통제 기준만 명시한다.
84
+
85
+ * 변경 요청 기록: {CHANGE_REQUEST_LOCATION}
86
+ * 승인 권한자: {CHANGE_APPROVER}
87
+
88
+ ## 5. Configuration Status Accounting
89
+
90
+ > 형상 상태 기록(status accounting) — 현재 각 CI의 버전·상태를 추적·보고하는 방법.
91
+
92
+ {STATUS_ACCOUNTING_METHOD}
93
+
94
+ ## 6. Configuration Audit
95
+
96
+ > 형상 감사 일정·기준. 기능/물리 형상 감사(Functional/Physical Configuration Audit).
97
+
98
+ * 감사 주기: {AUDIT_FREQUENCY}
99
+ * 감사 기준: {AUDIT_CRITERIA}
100
+
101
+ ## 7. Configuration Item Control Before Verification
102
+
103
+ > 검증 활동 시작 전, 검증 대상 형상 항목이 통제되어야 함. 검증 대상 CI 식별·고정 방법.
104
+
105
+ {PRE_VERIFICATION_CONTROL}
106
+
107
+ ## 8. Roles
108
+
109
+ | Title | Name(s) |
110
+ | --------------------- | ------- |
111
+ | Configuration Manager | |
112
+ | Release Manager | |