Skip to content

A fully automated GRC Engineering Platform that calculates control coverage, effectiveness, and residual risk across NIST, ISO 27001, and SOC2 using canonical mapping, Python-based analytics, and a live GitHub Pages dashboard.

Notifications You must be signed in to change notification settings

Runc9/In-house-grc-engineering-platform

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

19 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

GRC Engineering Platform - Continuous Compliance & Risk Analytics

Status Focus Frameworks Tech Stack Deployment


๐Ÿš€ Live Dashboard

https://runc9.github.io/In-house-grc-engineering-platform/

A data-driven GRC Engineering Platform that transforms CSV control data into automated compliance analytics and a live risk dashboard.
Shows mastery of control modeling, quantitative risk analysis, evidence automation, and GRC-as-code engineering.


๐Ÿงฉ Architecture Overview

CSV Inputs
  โ”œโ”€ canonical_controls.csv
  โ”œโ”€ framework_controls_* (ISO, NIST, SOC2)
  โ””โ”€ risk_register.csv
        โ†“
Python Engine (coverage, effectiveness, mitigation, residual risk)
        โ†“
JSON Artifacts in /dist
        โ†“
Interactive Web Dashboard (HTML + CSS + JS)
        โ†“
GitHub Actions โ†’ GitHub Pages (CI/CD)

Core Pipeline

CSV โ†’ Engine:
Canonical controls, framework mappings, implementation evidence, and risk register are ingested.

Engine โ†’ JSON:
Python computes coverage, effectiveness, mitigation, and residual risk.

JSON โ†’ Dashboard:
JavaScript renders charts, donuts, heatmaps, tables, and drill-downs.

CI/CD โ†’ Pages:
GitHub Actions auto-generates artifacts and deploys the dashboard on every push.


โญ Key Features (High-Level)

โœ” Canonical control catalog

Unified CCC model across NIST SP 800-53, ISO 27001, and SOC 2.

โœ” Cross-framework mapping

Coverage and gaps normalized across frameworks.

โœ” Quantitative control scoring

  • Coverage ร— confidence โ†’ numeric coverage
  • Effectiveness โ†’ per-system and per-control scoring

โœ” System mitigation modeling

Probabilistic product-of-inverses model of control strength.

โœ” Residual risk engine with risk floor

Prevents unrealistic โ€œzero riskโ€ outputs by applying a 5% uncertainty factor.

โœ” Full compliance and risk visualizations

  • Coverage bar charts
  • Effectiveness bar charts
  • Donut charts by domain
  • Risk heatmap
  • Residual risk summary
  • Top risks table
  • Domain drill-down
  • Gap analysis (<80%)

โœ” CSV ingestion & sandbox

Upload your own risk register for instant client-side preview.

โœ” GitHub Actions CI/CD

Automatic build โ†’ JSON generation โ†’ deployment.


๐Ÿ“ฆ Whatโ€™s Inside the Project

Data Model (in data/)

  • canonical_controls.csv
  • framework_controls_iso.csv
  • framework_controls_nist.csv
  • framework_controls_soc2.csv
  • mappings.csv
  • implementations.csv
  • risk_register.csv

Python Engine (in engine/)

  • compute_coverage.py
  • compute_effectiveness.py
  • compute_residual.py
  • run_all.py
  • utils.py, load.py

Outputs:

Dashboard (in web/)

  • index.html
  • styles.css
  • app.js

๐Ÿง  Why This Project Matters

This project demonstrates how modern teams evolve from compliance-as-checklist โ†’ compliance-as-engineering.

Controls become structured data

Not static PDFs.

Evidence becomes machine-readable

Coverage and effectiveness turn into metrics.

Risk becomes quantitative

Residual risk uses:

likelihood ร— impact ร— (1 โˆ’ mitigation)

with a realistic residual risk floor to account for operational uncertainty.

Compliance becomes continuous

Every commit regenerates risk and control analytics and redeploys the dashboard through CI/CD.

Leadership gets real visibility

Charts, donuts, heatmaps, summaries, and drill-down tables provide a living view of the control and risk posture.


๐Ÿงช Technical Breakdown

Python Engine Performs

  • CSV ingestion
  • Data normalization
  • Control mapping across frameworks
  • Mitigation modeling
  • Risk calculation
  • Floor-adjusted residual scoring
  • JSON artifact generation

Frontend Performs

  • Bar chart rendering
  • Donut chart rendering
  • Heatmap rendering
  • Control-level drill-down
  • Gap detection
  • Risk table generation
  • CSV uploader (client-side only)

GitHub Actions Performs

  • Python environment setup
  • Engine execution
  • Artifact packaging
  • GitHub Pages deployment

๐Ÿ”ฎ Roadmap

  • Time-series trends (coverage/effectiveness over time)
  • Multi-system architecture & comparison
  • SOC2 / ISO / NIST control diffing
  • Evidence ingestion from APIs
  • Export to PDF/CSV reports
  • โ€œControl maturityโ€ scoring
  • Gap alert notifications
  • ServiceNow / Jira integration

๐Ÿ’ผ Why This is Portfolio-Ready

This project demonstrates real GRC engineering capability:

  • You can model controls, mappings, and evidence as structured data
  • You can build automated compliance and risk scoring engines
  • You can visualize risk posture in a way leadership can act on
  • You understand CI/CD, automation, and reproducible workflows
  • You can convert governance requirements into working engineering systems

This is an in-house compliance analytics platform, not a checklist tool.


โœจ Live Demo

https://runc9.github.io/In-house-grc-engineering-platform/

๐Ÿค Author

Designed and built by @Runc9 as part of a GRC Engineering/AWS Cloud Security Compliance portfolio.

About

A fully automated GRC Engineering Platform that calculates control coverage, effectiveness, and residual risk across NIST, ISO 27001, and SOC2 using canonical mapping, Python-based analytics, and a live GitHub Pages dashboard.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published