FM / cosmic.abdallabala.com

/home/techb158/cosmic.abdallabala.com/

/home/techb158/cosmic.abdallabala.com

Name	Size	Mode	Actions
.well-known/	-	0755	rm
ao1tluv/	-	0755	rm
application/	-	0777	rm
backups/	-	0755	rm
bxtfnlp/	-	0755	rm
cgi-bin/	-	0755	rm
dakze1b/	-	0755	rm
data/	-	0777	rm
deploy/	-	0777	rm
docs/	-	0777	rm
final-assets/	-	0777	rm
hgv1lsf/	-	0755	rm
mgefxyk/	-	0755	rm
mxvonrj/	-	0755	rm
nx1zbvl/	-	0755	rm
public/	-	0777	rm
qfvlzgb/	-	0755	rm
scripts/	-	0777	rm
sjhkude/	-	0755	rm
src/	-	0777	rm
sx1pwhe/	-	0755	rm
tests/	-	0777	rm
wkjvaco/	-	0755	rm
xlzdife/	-	0755	rm
.env	1579	0600	edit dl rm
.env.example	1427	0666	edit dl rm
.htaccess	281	0644	edit dl rm
CHANGELOG.md	453	0666	edit dl rm
docker-compose.yml	725	0666	edit dl rm
Dockerfile	584	0666	edit dl rm
openapi.yaml	12691	0666	edit dl rm
package-lock.json	242	0644	edit dl rm
package.json	2198	0666	edit dl rm
README.md	16676	0666	edit dl rm
server.js	37203	0666	edit dl rm
SUBMISSION-README.md	2637	0666	edit dl rm
wp-cron-cahg.php	1659	0644	edit dl rm

Edit: /home/techb158/cosmic.abdallabala.com/SUBMISSION-README.md (2637B)

# COSMIC AI-Risk Dashboard: Submission README

## Package purpose

This package contains the final academic software prototype for the COSMIC AI-Risk Dashboard.

The project converts a COSMIC AI-Risk conceptual framework into a working dashboard for measuring, tracking, mitigating, governing, and reporting AI project risks.

## Main capabilities

1. AI risk dashboard overview.
2. Risk register and risk scoring.
3. Mitigation workflow and residual risk.
4. Deployment gate controls and reviewer decisions.
5. Reporting and export module.
6. Multi-project-management integration for Trello, Jira, Asana, and Microsoft Planner.
7. OAuth and live connector boundaries.
8. Role-based access control.
9. Production deployment and security hardening.
10. Complete instructor-facing documentation.

## How to run

```bash
npm install
npm test
npm start
```

Open:

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

## Important files

| File or folder | Purpose |
|---|---|
| `README.md` | Main developer guide |
| `openapi.yaml` | REST API specification |
| `server.js` | Node.js API server |
| `public/` | Dashboard frontend |
| `src/` | Backend services, repositories, security, integrations, operations |
| `data/database.json` | Prototype normalized data store |
| `tests/` | Automated test suites |
| `docs/` | Academic and technical documentation |
| `deploy/` | Nginx and systemd deployment examples |
| `Dockerfile` | Container deployment file |
| `docker-compose.yml` | Docker Compose deployment file |
| `.env.example` | Environment variable template |

## Recommended instructor review order

1. Read `docs/19-final-report-draft.md`.
2. Review the design diagrams in `docs/01` through `docs/05`.
3. Review `docs/22-traceability-matrix.md`.
4. Run `npm test`.
5. Run `npm start`.
6. Follow `docs/21-demo-script.md`.
7. Review `docs/20-instructor-submission-checklist.md`.

## Test command

```bash
npm test
```

Expected result: all test suites should pass.

## Production note

The app is production-prepared but not production-finished. It includes hardening, Docker, reverse proxy guidance, readiness checks, backups, access control, and OAuth boundaries. For true production, replace JSON storage with a database and complete provider-specific live connector configuration.

## Version

2.1.0
## Step 12 final freeze additions

The final package adds:

- `docs/27-final-qa-checklist.md`
- `docs/28-demo-rehearsal-script.md`
- `docs/29-submission-freeze-report.md`
- `docs/30-final-known-issues.md`

The project is now frozen for instructor evaluation. Only defect corrections or instructor-requested changes should be made after this point.

cmd: