FM / docs

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

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

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

Edit: /home/techb158/cosmic.abdallabala.com/docs/20-instructor-submission-checklist.md (3639B)

# Instructor Submission Checklist

Use this checklist before submitting or demonstrating the COSMIC AI-Risk Dashboard.

## 1. Source alignment

| Item | Status |
|---|---|
| The project explains the source framework basis | Complete |
| The distinction between source-derived content and implementation extension is clear | Complete |
| Organizational, technical, and human dimensions are included | Complete |
| ISO-style indicators, measurands, units, and interpretation rules are included | Complete |
| The software prototype and API direction are reflected | Complete |
| Project management integration is included | Complete |

## 2. Design artifacts

| Artifact | File | Status |
|---|---|---|
| Design study | `docs/00-design-study.md` | Complete |
| UML class diagram | `docs/01-uml-class-diagram.puml` | Complete |
| Use case diagram | `docs/02-use-case-diagram.puml` | Complete |
| Sequence diagrams | `docs/03-sequence-diagrams.puml` | Complete |
| Database entity model | `docs/04-database-entity-model.mmd` | Complete |
| SQL schema draft | `docs/05-database-schema.sql` | Complete |
| Traceability matrix | `docs/22-traceability-matrix.md` | Complete |

## 3. Application features

| Feature | Status |
|---|---|
| Dashboard overview | Complete |
| Risk register | Complete |
| Risk scoring | Complete |
| Mitigation workflow | Complete |
| Residual risk calculation | Complete |
| Deployment gate | Complete |
| Reviewer decisions | Complete |
| Gate history | Complete |
| Audit trail | Complete |
| Reporting and export | Complete |
| Multi-PM integration adapter | Complete |
| OAuth/live connector boundary | Complete |
| Role-based access control | Complete |
| Production hardening | Complete |

## 4. Supported PM applications

| Application | Status |
|---|---|
| Trello | Supported |
| Jira Cloud | Supported |
| Asana | Supported |
| Microsoft Planner | Supported |

## 5. API and documentation

| Item | Status |
|---|---|
| `openapi.yaml` is included | Complete |
| README explains how to run the app | Complete |
| `.env.example` is included | Complete |
| Dockerfile is included | Complete |
| Docker Compose file is included | Complete |
| Nginx example is included | Complete |
| systemd example is included | Complete |

## 6. Tests

Run this before submission:

```bash
npm test
```

Expected result:

```text
All COSMIC AI-Risk engine tests passed.
All COSMIC AI-Risk storage layer tests passed.
All COSMIC AI-Risk mitigation workflow tests passed.
All COSMIC AI-Risk gate workflow tests passed.
All COSMIC AI-Risk integration workflow tests passed.
All COSMIC AI-Risk OAuth and live connector tests passed.
All COSMIC AI-Risk reporting workflow tests passed.
All COSMIC AI-Risk access control tests passed.
All COSMIC AI-Risk production hardening tests passed.
All COSMIC AI-Risk API workflow tests passed.
```

## 7. Demo preparation

| Step | Status |
|---|---|
| Start server with `npm start` | To verify |
| Open `http://localhost:8090` | To verify |
| Show dashboard overview | To verify |
| Create or edit a risk | To verify |
| Add mitigation evidence | To verify |
| Evaluate deployment gate | To verify |
| Show gate decision history | To verify |
| Show PM integrations | To verify |
| Show reports page | To verify |
| Show access control page | To verify |
| Run tests | To verify |

## 8. Final submission files

Submit the complete project folder or the final zip package. The package should include:

1. Source code.
2. Public dashboard files.
3. Data files.
4. API specification.
5. Documentation files.
6. UML and database diagrams.
7. Tests.
8. Deployment files.
9. Submission README.

cmd: