/home/techb158/cosmic.abdallabala.com
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.