FM / docs

/home/techb158/trellopowerup.abdallabala.com/docs/

/home/techb158/trellopowerup.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-trello-powerup-implementation-guide.md	7608	0644	edit dl rm
32-vps-deployment-guide.md	3697	0644	edit dl rm
dashboard-spec.md	3691	0644	edit dl rm
methodology-mapping.md	2471	0644	edit dl rm
next-implementation-step.md	1304	0644	edit dl rm
trello-admin-setup.md	2175	0644	edit dl rm

Edit: /home/techb158/trellopowerup.abdallabala.com/docs/21-demo-script.md (3948B)

# COSMIC AI-Risk Dashboard Demo Script

This script provides a structured 10 to 15 minute instructor demonstration.

## 1. Opening statement

This prototype converts the COSMIC AI-Risk conceptual framework into a working software dashboard. The goal is to measure, manage, mitigate, and govern AI project risks through a practical software application.

## 2. Source foundation

Explain that the project is based on the COSMIC AI-Risk direction, including measurable AI risk, organizational, technical, and human governance dimensions, indicators, REST API support, software prototype delivery, and PM tool integration.

## 3. Show the design-first approach

Open these files:

```text
docs/01-uml-class-diagram.puml
docs/02-use-case-diagram.puml
docs/03-sequence-diagrams.puml
docs/04-database-entity-model.mmd
```

Explain that development followed the diagrams instead of starting from UI only.

## 4. Start the application

```bash
npm start
```

Open:

```text
http://localhost:8090
```

## 5. Dashboard overview

Show:

1. Overall risk score.
2. Risk level.
3. Deployment gate status.
4. Organizational, technical, and human risk dimensions.
5. Lifecycle readiness.
6. Top risks.

Suggested explanation:

The overview gives project managers a measurable risk posture instead of a purely qualitative assessment.

## 6. Risk register workflow

Open the Risk Register tab.

Demonstrate:

1. Add a new AI risk.
2. Select lifecycle phase and risk dimension.
3. Enter probability, impact, and detectability.
4. Save the risk.
5. Observe dashboard recalculation.

Suggested explanation:

Each risk is linked to the AI lifecycle and governance dimension. The risk engine produces a normalized score.

## 7. Mitigation workflow

Open the Mitigations tab.

Demonstrate:

1. Add mitigation to a risk.
2. Set progress and effectiveness.
3. Attach evidence reference.
4. Mark mitigation as done.
5. Show residual risk impact.

Suggested explanation:

The mitigation workflow connects risk treatment to measurable residual risk.

## 8. Deployment gate workflow

Open the Deployment Gate tab.

Demonstrate:

1. Run gate evaluation.
2. Show blocked, warning, or ready state.
3. Add reviewer decision.
4. Add criterion notes.
5. Show gate history and audit trail.

Suggested explanation:

The deployment gate converts risk measurement into governance control.

## 9. PM integration workflow

Open the PM Integrations tab.

Show supported tools:

1. Trello.
2. Jira.
3. Asana.
4. Microsoft Planner.

Demonstrate simulated sync. Explain that live connector boundaries and OAuth flows are included, but real credentials are not committed to the project.

## 10. Reporting workflow

Open the Reports tab.

Show:

1. Executive report.
2. Printable HTML report.
3. Risk register CSV.
4. Mitigation CSV.
5. Gate report.
6. Audit report.

Suggested explanation:

The reporting module provides instructor-ready and governance-ready evidence.

## 11. Access control workflow

Open the Access Control tab.

Show:

1. Current actor.
2. Roles.
3. Permission matrix.
4. Disabled actions for users without permissions.

Suggested explanation:

The dashboard includes governance controls so sensitive actions such as OAuth configuration, gate approval, and user management can be restricted.

## 12. Production readiness

Show:

```text
Dockerfile
docker-compose.yml
deploy/nginx.conf
deploy/cosmic-ai-risk-dashboard.service
```

Run:

```bash
npm run check:config
npm run backup
```

Explain readiness endpoint:

```text
/api/ready
```

## 13. Tests

Run:

```bash
npm test
```

Explain that tests cover the risk engine, storage, mitigation, gate, integrations, OAuth boundaries, reporting, access control, production hardening, and API workflows.

## 14. Closing statement

The prototype demonstrates a complete path from academic framework to software artifact: diagrams, data model, services, API, UI, workflows, security controls, reporting, and deployment preparation.

cmd: