FM / docs

/home/techb158/cosmic-risk.abdallabala.com/docs/

/home/techb158/cosmic-risk.abdallabala.com/docs

Name	Size	Mode	Actions
00-design-study.md	3678	0644	edit dl rm
01-uml-class-diagram.puml	11869	0644	edit dl rm
02-use-case-diagram.puml	3763	0644	edit dl rm
03-sequence-diagrams.puml	9732	0644	edit dl rm
04-database-entity-model.mmd	7051	0644	edit dl rm
05-database-schema.sql	13372	0644	edit dl rm
06-diagram-preview.html	5021	0644	edit dl rm
07-design-checklist.md	3256	0644	edit dl rm
08-step-2-storage-layer.md	5325	0644	edit dl rm
09-step-3-risk-crud-ui.md	3380	0644	edit dl rm
10-step-4-mitigation-workflow.md	3996	0644	edit dl rm
11-step-5-deployment-gate-workflow.md	2292	0644	edit dl rm
12-step-6-multi-pm-integration.md	3770	0644	edit dl rm
13-step-6-1-microsoft-planner-integration.md	2335	0644	edit dl rm
14-step-7-reporting-export.md	4158	0644	edit dl rm
15-step-7-1-oauth-live-connectors.md	4545	0644	edit dl rm
16-step-8-user-roles-access-control.md	3297	0644	edit dl rm
17-step-9-production-deployment-security.md	4228	0644	edit dl rm
18-step-10-final-academic-submission.md	3199	0644	edit dl rm
19-final-report-draft.md	6814	0644	edit dl rm
20-instructor-submission-checklist.md	3639	0644	edit dl rm
21-demo-script.md	3948	0644	edit dl rm
22-traceability-matrix.md	4847	0644	edit dl rm
23-testing-evidence.md	2961	0644	edit dl rm
24-evaluation-rubric-mapping.md	2910	0644	edit dl rm
25-final-deployment-runbook.md	3214	0644	edit dl rm
26-known-limitations-and-future-work.md	2632	0644	edit dl rm
27-final-qa-checklist.md	2893	0644	edit dl rm
28-demo-rehearsal-script.md	3618	0644	edit dl rm
29-submission-freeze-report.md	2769	0644	edit dl rm
30-final-known-issues.md	1876	0644	edit dl rm
31-saas-rebuild-implementation.md	2573	0644	edit dl rm
application-documentation.md	27515	0644	edit dl rm
conversation-log.md	18503	0644	edit dl rm
dashboard-spec.md	3691	0644	edit dl rm
database-guide.md	37826	0644	edit dl rm
development-summary.md	7070	0644	edit dl rm
github-architecture.svg	6288	0644	edit dl rm
integration-pull-push-plan.md	7384	0644	edit dl rm

Edit: /home/techb158/cosmic-risk.abdallabala.com/docs/07-design-checklist.md (3256B)

# COSMIC AI-Risk Dashboard, Instructor Design Checklist

## 1. Required diagrams

| Required item | File | Status |
|---|---|---|
| UML Class Diagram | `01-uml-class-diagram.puml` | Complete |
| Use Case Diagram | `02-use-case-diagram.puml` | Complete |
| Sequence Diagrams | `03-sequence-diagrams.puml` | Complete |
| Database Entity Model | `04-database-entity-model.mmd` | Complete |
| Database schema | `05-database-schema.sql` | Complete |

## 2. Source traceability

| Requirement | Source basis | Implementation mapping |
|---|---|---|
| Quantify AI risk | COSMIC-Risk measurement objective | RiskScore, RiskScoringService, project risk score |
| Organizational, technical, human dimensions | AI Governance Triangle | Risk.dimension and dimension scores |
| ISO-style indicators | ISO 15939 and VIM measurement intent | Indicator and MeasurementRecord entities |
| Software prototype and API | COSMIC-Risk objectives and timeline | API controllers and service classes |
| PM tool integration | Methodology mentions PM tool integration | ProjectManagementIntegration, ExternalWorkItemMapping, and ProjectManagementIntegrationService |
| Risk profiles by project typology | COSMIC-Risk project typology | Project.projectType field |

## 3. Feature-to-design rule

Each feature must be implemented only after it maps to the design model.

| Feature | Use case | Class | Entity | API |
|---|---|---|---|---|
| Create risk | Register AI risk | Risk, RiskService | risks | POST /api/projects/{id}/risks |
| Score risk | Score risk | RiskScore, RiskScoringService | risk_scores | POST /api/projects/{id}/calculate-risk |
| Add mitigation | Add mitigation action | MitigationAction | mitigation_actions | POST /api/risks/{id}/mitigations |
| Record indicator | Record indicator measurement | Indicator, MeasurementRecord | indicators, measurement_records | POST /api/projects/{id}/measurements |
| Track experiment | Track experiment | Experiment, ModelMetric | experiments, model_metrics | POST /api/projects/{id}/experiments |
| Evaluate gate | Evaluate deployment gate | DeploymentGate, GateCriterion | deployment_gates, gate_criteria | POST /api/projects/{id}/gate/evaluate |
| Sync PM work item | Sync Trello/Jira/Asana work item | ProjectManagementIntegration, ExternalWorkItemMapping, ProjectManagementSyncRun | project_management_integrations, external_work_item_mappings, project_management_sync_runs | POST /api/integrations/{integrationId}/sync |

## 4. Development sequence after instructor approval

1. Confirm diagrams and database model.
2. Update JSON storage to match the entity model.
3. Add service layer files.
4. Add API endpoints by use case.
5. Add tests for scoring and gate decisions.
6. Connect UI screens to stable endpoints.
7. Add multi-PM synchronization only after local risk flow works.

## 5. Open decisions before coding

| Decision | Recommended answer |
|---|---|
| MVP database | Keep JSON storage during prototype, migrate to SQLite or PostgreSQL after diagrams are approved |
| User authentication | Use role model now, add login later |
| Risk scoring formula | Keep normalized score and residual score as implementation extension |
| Multi-PM integration | Implement after risk CRUD and gate evaluation are stable |

cmd: